set_line_style

set_line_style ( : : WindowHandle, Style : )

Define a contour output pattern.

set_line_style defines the output pattern of region contours. The information is used by procedures like disp_region, disp_line, disp_polygon etc. The current value can be queried with get_line_style. Style contains up to five pairs of values. The first value is the length of the visible contour part, the second is the length of the invisible part. The value pairs are used cyclical for contour output.

Attention

set_line_style does an implicit polygon approximation (see set_line_approx(::WindowHandle,3:)). It is only possible to enlarge it with set_line_approx.

Parameters

`WindowHandle` (input_control)	window `->` integer
Window_id.

`Style` (input_control)	integer-array `->` integer
Contour pattern.
Default value: '[]'

Example

* stroke line: X-Windows
set_line_style(WindowHandle,[20,7])
* point-stroke line: X-Windows
set_line_style(WindowHandle,[20,7,3,7])
* passing line (standard)
set_line_style(WindowHandle,[])

Result

set_line_style returns 2 (H_MSG_TRUE) if the parameter is correct and the window is valid. Otherwise an exception handling is raised.

Parallelization Information

set_line_style is reentrant, local, and processed without parallelization.

Possible Predecessors

get_line_style

Possible Successors

disp_region

Module

Foundation