detach_drawing_object_from_windowT_detach_drawing_object_from_windowDetachDrawingObjectFromWindowDetachDrawingObjectFromWindowdetach_drawing_object_from_window (Operator)

Name

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

Signature

detach_drawing_object_from_window( : : WindowHandle, DrawHandle : )

Description

This operator can be used to detach the drawing object DrawHandleDrawHandleDrawHandleDrawHandledrawHandledraw_handle from the HALCON window WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_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_callbackset_drawing_object_callbackSetDrawingObjectCallbackSetDrawingObjectCallbackSetDrawingObjectCallbackset_drawing_object_callback this will also be called.

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

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control) window → (handle)

Window Handle.

DrawHandleDrawHandleDrawHandleDrawHandledrawHandledraw_handle (input_control) drawing_object → (handle)

Handle of the drawing object.

Result

detach_drawing_object_from_windowdetach_drawing_object_from_windowDetachDrawingObjectFromWindowDetachDrawingObjectFromWindowDetachDrawingObjectFromWindowdetach_drawing_object_from_window returns 2 ( H_MSG_TRUE) , if the DrawHandleDrawHandleDrawHandleDrawHandledrawHandledraw_handle and WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle are valid. Otherwise an exception is raised.