Skip to content

detach_drawing_object_from_windowDetachDrawingObjectFromWindowDetachDrawingObjectFromWindowdetach_drawing_object_from_windowT_detach_drawing_object_from_window🔗

Short description🔗

detach_drawing_object_from_windowDetachDrawingObjectFromWindowDetachDrawingObjectFromWindowdetach_drawing_object_from_windowT_detach_drawing_object_from_window — Detach an existing drawing object from a HALCON window.

Signature🔗

detach_drawing_object_from_window( window WindowHandle, drawing_object DrawHandle )void DetachDrawingObjectFromWindow( const HTuple& WindowHandle, const HTuple& DrawHandle )static void HOperatorSet.DetachDrawingObjectFromWindow( HTuple windowHandle, HTuple drawHandle )def detach_drawing_object_from_window( window_handle: HHandle, draw_handle: HHandle ) -> None

Herror T_detach_drawing_object_from_window( const Htuple WindowHandle, const Htuple DrawHandle )

void HWindow::DetachDrawingObjectFromWindow( const HDrawingObject& DrawHandle ) const

void HWindow.DetachDrawingObjectFromWindow( HDrawingObject drawHandle )

Description🔗

This operator can be used to detach the drawing object DrawHandledrawHandledraw_handle from the HALCON window WindowHandlewindowHandlewindow_handle to which it is currently attached. The drawing object will not longer be displayed in the window. If a callback function was defined for the drawing object on the event ‘on_detach’ or ‘on_select’ with set_drawing_object_callbackSetDrawingObjectCallback this will also be called.

Execution information🔗

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🔗

WindowHandlewindowHandlewindow_handle (input_control) window → (handle)HTuple (HHandle)HWindow, HTuple (IntPtr)HHandleHtuple (handle)

Window Handle.

DrawHandledrawHandledraw_handle (input_control) drawing_object → (handle)HTuple (HHandle)HDrawingObject, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the drawing object.

Result🔗

detach_drawing_object_from_windowDetachDrawingObjectFromWindow returns 2 (H_MSG_TRUE), if the DrawHandledrawHandledraw_handle and WindowHandlewindowHandlewindow_handle are valid. Otherwise an exception is raised.

Combinations with other operators🔗

Combinations

Possible predecessors

attach_drawing_object_to_windowAttachDrawingObjectToWindow, get_drawing_object_iconicGetDrawingObjectIconic, get_drawing_object_paramsGetDrawingObjectParams

Possible successors

close_windowCloseWindow, clear_drawing_objectClearDrawingObject

See also

attach_drawing_object_to_windowAttachDrawingObjectToWindow

Module🔗

Foundation