Plot.DrawSetPenWidth

Prototypes

void DrawSetPenWidth( int nWidth )

Parameters

int nWidth
The new width of the pen, in units of screen pixels. This parameter must be in the range 0-1024. The value zero causes lines to be drawn as hairlines (see below).

Remarks

This method sets the width of the pen, in units of screen pixels. There is only one pen and it is shared by all three drawing regions (PLOTBACKGROUND, PLOTFOREGROUND, GRAPHFOREGROUND). The pen is used to draw lines and grids as well as to draw the outline of figures such as arcs, markers, rectangles, and polygons.

If you set the pen width to zero, lines are drawn as hairlines. A hairline is a line that is always drawn one pixel wide regardless of the resolution of the device on which it is rendered. In IML Studio, setting the pen width to zero will cause lines to be drawn one pixel wide even if the plot is printed or copied to another application and then resized.

The default pen width is 1 screen pixel.

Example
x = { 1 2 3 4 5 6 7 8 };
y = { 2 1 4 5 6 5 6 9 };
declare ScatterPlot plot;
plot = ScatterPlot.Create( "Sample Data", x, y );
plot.DrawSetPenWidth( 3 );
plot.DrawUseDataCoordinates();
plot.DrawLine( x, y );
See Also

Plot.DrawSetPenAttributes
Plot.DrawSetPenColor
Plot.DrawSetPenStyle