set_window_dcT_set_window_dcSetWindowDcSetWindowDcset_window_dc (Operator)
Name
set_window_dcT_set_window_dcSetWindowDcSetWindowDcset_window_dc
— Set the device context of a virtual graphics window (Windows NT).
Signature
Description
set_window_dcset_window_dcSetWindowDcSetWindowDcset_window_dc
sets the device context of a window previously
opened with new_extern_windownew_extern_windowNewExternWindowNewExternWindownew_extern_window
. All output
(disp_regiondisp_regionDispRegionDispRegiondisp_region
, disp_imagedisp_imageDispImageDispImagedisp_image
, etc.) is done in the
window with this device context.
The parameter WINHDCWINHDCWINHDCWINHDCwinhdc
contains the device context of the
window in which HALCON should output its data. This device context
is used in all output routines of HALCON.
Attention
The window WindowHandleWindowHandleWindowHandlewindowHandlewindow_handle
has to be created with
new_extern_windownew_extern_windowNewExternWindowNewExternWindownew_extern_window
beforehand.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
WindowHandleWindowHandleWindowHandlewindowHandlewindow_handle
(input_control) window →
HWindow, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Window handle.
WINHDCWINHDCWINHDCWINHDCwinhdc
(input_control) pointer →
HTupleintHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)
device context of WINHWnd.
Restriction:
WINHDC != 0
Result
If the values of the specified parameters are correct,
set_window_dcset_window_dcSetWindowDcSetWindowDcset_window_dc
returns 2 (
H_MSG_TRUE)
. If necessary, an exception is
raised.
Possible Predecessors
new_extern_windownew_extern_windowNewExternWindowNewExternWindownew_extern_window
Possible Successors
disp_imagedisp_imageDispImageDispImagedisp_image
,
disp_regiondisp_regionDispRegionDispRegiondisp_region
See also
new_extern_windownew_extern_windowNewExternWindowNewExternWindownew_extern_window
,
disp_regiondisp_regionDispRegionDispRegiondisp_region
,
disp_imagedisp_imageDispImageDispImagedisp_image
,
disp_colordisp_colorDispColorDispColordisp_color
,
set_lutset_lutSetLutSetLutset_lut
,
query_colorquery_colorQueryColorQueryColorquery_color
,
set_colorset_colorSetColorSetColorset_color
,
set_rgbset_rgbSetRgbSetRgbset_rgb
,
set_hsiset_hsiSetHsiSetHsiset_hsi
,
set_pixelset_pixelSetPixelSetPixelset_pixel
,
set_grayset_graySetGraySetGrayset_gray
,
set_partset_partSetPartSetPartset_part
,
set_part_styleset_part_styleSetPartStyleSetPartStyleset_part_style
,
query_window_typequery_window_typeQueryWindowTypeQueryWindowTypequery_window_type
,
get_window_typeget_window_typeGetWindowTypeGetWindowTypeget_window_type
,
set_window_typeset_window_typeSetWindowTypeSetWindowTypeset_window_type
,
get_mpositionget_mpositionGetMpositionGetMpositionget_mposition
,
set_tpositionset_tpositionSetTpositionSetTpositionset_tposition
,
set_window_extentsset_window_extentsSetWindowExtentsSetWindowExtentsset_window_extents
,
get_window_extentsget_window_extentsGetWindowExtentsGetWindowExtentsget_window_extents
,
set_window_attrset_window_attrSetWindowAttrSetWindowAttrset_window_attr
,
set_checkset_checkSetCheckSetCheckset_check
,
set_systemset_systemSetSystemSetSystemset_system
Module
Foundation