cdCanvasLineStyle

Definition: include pGUI.e

cdCanvasLineStyle(cdCanvas hCdCanvas, integer style)
Description: Configures the style of the current line.
Comments: Valid settings for style are: CD_CONTINUOUS, CD_DASHED, CD_DOTTED, CD_DASH_DOT, CD_DASH_DOT_DOT, or CD_CUSTOM. Default value: CD_CONTINUOUS.

When CD_CUSTOM is used the cdLineStyleDashes function must be called before to initialize the custom dashes.

The spaces are drawn with the background color, except when back opacity is transparent then the background is left unchanged. See BackOpacity.

To retrieve the current value, use integer style = cdCanvasGetLineStyle(cdCanvas hCdCanvas).

If you find C code along the lines of old_width = cdCanvasLineStyle(ih,new_width);, it must be replaced with two calls. Also replace current_width = cdCanvasLineStyle(ih,CD_QUERY) with current_width = cdCanvasGetLineStyle(ih).

In Phix, the procedure cdCanvasSetLineStyle is identical to cdCanvasLineStyle.