Herror ::set_window_dc (
    const HTuple &WindowHandle,
    const HTuple &WINHDC
)
void HWindow::SetWindowDc (
    const HTuple &WINHDC
) const

Set the device context of a virtual graphics window (Windows NT).

::set_window_dc sets the device context of a window previously opened with ::new_extern_window. All output (::disp_region, ::disp_image, etc.) is done in the window with this device context.

The parameter WINHDC 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 WindowHandle has to be created with ::new_extern_window beforehand.


Parameters

WindowHandle (input_control)
window -> HTuple.long
Window identifier.

WINHDC (input_control)
integer -> HTuple.long
devicecontext of WINHWnd.
Restriction: WINHDC != 0


Example
set_system("pixel_ratio",1.53) ;
hWnd = createWINDOW(...) ;
new_extern_window(hwnd, hdc, 0,0,400,-1,WindowHandle) ;
set_device_context(WindowHandle, hdc) ;
read_image(&Image,"fabrik") ;
disp_image(Image,WindowHandle) ;
write_string(WindowHandle,"File: fabrik.ima") ;
new_line(WindowHandle) ;
get_mbutton(WindowHandle,_,_,_) ;
set_lut(WindowHandle,"temperature") ;
set_color(WindowHandle,"blue") ;
write_string(WindowHandle,"temperature") ;
new_line(WindowHandle) ; 
write_string(WindowHandle,"Draw Rectangle") ;
new_line(WindowHandle) ;
draw_rectangle1(WindowHandle,&Row1,&Column1,&Row2,&Column2) ;
set_part(Row1,Column1,Row2,Column2) ;
disp_image(Image,WindowHandle) ;
new_line(WindowHandle) ;

Result

If the values of the specified parameters are correct, ::set_window_dc returns H_MSG_TRUE. If necessary, an exception is raised.


Possible Predecessors

::new_extern_window


Possible Successors

::disp_image, ::disp_region


See also

::new_extern_window, ::disp_region, ::disp_image, ::disp_color, ::set_lut, ::query_color, ::set_color, ::set_rgb, ::set_hsi, ::set_pixel, ::set_gray, ::set_part, ::set_part_style, ::query_window_type, ::get_window_type, ::set_window_type, ::get_mposition, ::set_tposition, ::set_window_extents, ::get_window_extents, ::set_window_attr, ::set_check, ::set_system


Module

System



Copyright © 1996-2002 MVTec Software GmbH