set_line_style

Herror ::set_line_style ( const HTuple &WindowHandle, const HTuple &Style ) void HWindow::SetLineStyle ( const HTuple &Style ) const

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 `->` HTuple.long
Window_id.

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

Example

Htuple LineStyle ;

/* stroke line: X-Windows */
create_tuple(&LineStyle,2) ;
set_i(LineStyle,20,0) ;
set_i(LineStyle,7,1) ;
T_set_line_style(WindowHandle,LineStyle) ;
destroy_tuple(LineStyle) ;

/* point-stroke line: X-Windows */
create_tuple(&LineStyle,4) ;
set_i(LineStyle,20,0) ;
set_i(LineStyle,7,1) ;
set_i(LineStyle,3,2) ;
set_i(LineStyle,7,3) ;
T_set_line_style(WindowHandle,LineStyle) ;
destroy_tuple(LineStyle) ;

/* passing line (standard) */
create_tuple(&LineStyle,0) ;
T_set_line_style(WindowHandle,LineStyle) ;
destroy_tuple(LineStyle) ;

Result

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

Possible Predecessors

::get_line_style

Possible Successors

::disp_region

Module

System