Herror ::set_draw (
    const HTuple &WindowHandle,
    const HTuple &Mode
)
void HWindow::SetDraw (
    const HTuple &Mode
) const

Define the region fill mode.

::set_draw defines the region fill mode. If Mode is set to 'fill', output regions are filled, if set to 'margin', only contours are displayed. Setting Mode only affects the valid window. It is used by procedures with region output like ::disp_region, ::disp_circle, ::disp_rectangle1, ::disp_rectangle2, ::disp_arrow etc. It is also used by procedures with grayvalue output for some grayvalue output modes (e.g. 'histogram', see ::set_paint). If the mode is 'margin', the contour can be affected with ::set_line_width, ::set_line_approx and ::set_line_style.


Attention

If the output mode is 'margin' and the line width is more than one, objects may not be displayed.


Parameters

WindowHandle (input_control)
window -> HTuple.long
Window_id.

Mode (input_control)
string -> HTuple.char *
Fill mode for region output.
Default value: 'fill'
List of values: 'fill', 'margin'


Result

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


Possible Predecessors

::get_draw


Possible Successors

::disp_region


See also

::get_draw, ::disp_region, ::set_paint, ::disp_image, ::set_line_width, ::set_line_style


Module

System



Copyright © 1996-2002 MVTec Software GmbH