Plot.DrawSetPenAttributes

Prototypes

void DrawSetPenAttributes( int nColor, int nStyle, int nWidth )

Parameters

int nColor
A predefined constant specifying the new color of the pen. The valid values are BLACK, BLUE, BROWN, CHARCOAL, CREAM, CYAN, GOLD, GRAY, GREY, GREEN, LILAC, LIME, MAGENTA, MAROON, OLIVE, ORANGE, PINK, PURPLE, RED, ROSE, SALMON, STEEL, TAN, VIOLET, WHITE, and YELLOW.

int nStyle
A predefined constant specifying the new style of the pen. The valid values are OFF, SOLID, DASHED, DOTTED, DASHDOT, and DASHDOTDOT.

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 color, style, and width of the pen. Calling this method is equivalent to calling the following methods:

DrawSetPenColor
DrawSetPenStyle
DrawSetPenWidth

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.

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.DrawSetPenAttributes( RED, DOTTED, 3 );
plot.DrawUseDataCoordinates();
plot.DrawLine( x, y );
See Also

Plot.DrawSetPenColor
Plot.DrawSetPenStyle
Plot.DrawSetPenWidth