Name
set_drawing_object_callbackset_drawing_object_callbackSetDrawingObjectCallbackset_drawing_object_callbackSetDrawingObjectCallbackSetDrawingObjectCallback — Add a callback function to a drawing object.
set_drawing_object_callbackset_drawing_object_callbackSetDrawingObjectCallbackset_drawing_object_callbackSetDrawingObjectCallbackSetDrawingObjectCallback adds the callback function
CallbackFunctionCallbackFunctionCallbackFunctionCallbackFunctionCallbackFunctioncallbackFunction to be called on the event(s) defined in
DrawObjectEventDrawObjectEventDrawObjectEventDrawObjectEventDrawObjectEventdrawObjectEvent to the drawing object DrawIDDrawIDDrawIDDrawIDDrawIDdrawID.
An event is an action, i.e., a user interaction with the
mouse or a call to a HALCON operator, e.g.,
attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindow), that changes the current state of a
given drawing object. The operator set_drawing_object_callbackset_drawing_object_callbackSetDrawingObjectCallbackset_drawing_object_callbackSetDrawingObjectCallbackSetDrawingObjectCallback allows
to define how to react to those events.
The following predefined events are available:
- 'on_attach'"on_attach""on_attach""on_attach""on_attach""on_attach"
The corresponding callback will be called right after the object
has been attached to the HALCON window and is ready for interaction.
- 'on_detach'"on_detach""on_detach""on_detach""on_detach""on_detach"
The corresponding callback will be called right after the object
has been detached from the window and is no longer available for interaction.
- 'on_drag'"on_drag""on_drag""on_drag""on_drag""on_drag"
The corresponding callback will be called right after the object
has been dragged with mouse interaction.
- 'on_resize'"on_resize""on_resize""on_resize""on_resize""on_resize"
The corresponding callback will be called right after the object
has been resized with mouse interaction.
- 'on_select'"on_select""on_select""on_select""on_select""on_select"
The corresponding callback will be called right after the object
has been selected with mouse interaction.
It is possible to specify a particular callback for each desired event.
Then the input parameters DrawObjectEventDrawObjectEventDrawObjectEventDrawObjectEventDrawObjectEventdrawObjectEvent and CallbackFunctionCallbackFunctionCallbackFunctionCallbackFunctionCallbackFunctioncallbackFunction
must have the same length. It is also possible to use the same callback
for different events. Then DrawObjectEventDrawObjectEventDrawObjectEventDrawObjectEventDrawObjectEventdrawObjectEvent has an
arbitrary length and CallbackFunctionCallbackFunctionCallbackFunctionCallbackFunctionCallbackFunctioncallbackFunction contains one single value.
The callback is an integer of long type containing a pointer to a C function
with the following signature:
Herror HDrawObjCallback(long DrawID, long WindowHandle, char *type)
On Windows systems, the __stdcall naming convention is used:
Herror (__stdcall HDrawObjCallback)(long DrawID, long WindowHandle, char* type)
The first parameter of the callback function contains the handle to the draw
object that generated the event, the second one contains the handle of the
window where the interaction took place. Finally, the third parameter
indicates which event occurred.
No graphical operator should be called within the callback, like for example
disp_objdisp_objDispObjdisp_objDispObjDispObj, for otherwise a deadlock may occur.
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Handle of the drawing object.
Events to be captured.
Suggested values: 'on_resize'"on_resize""on_resize""on_resize""on_resize""on_resize", 'on_drag'"on_drag""on_drag""on_drag""on_drag""on_drag", 'on_attach'"on_attach""on_attach""on_attach""on_attach""on_attach", 'on_detach'"on_detach""on_detach""on_detach""on_detach""on_detach", 'on_select'"on_select""on_select""on_select""on_select""on_select"
set_drawing_object_callbackset_drawing_object_callbackSetDrawingObjectCallbackset_drawing_object_callbackSetDrawingObjectCallbackSetDrawingObjectCallback returns 2 (H_MSG_TRUE), if DrawIDDrawIDDrawIDDrawIDDrawIDdrawID is valid.
Otherwise an exception is raised.
attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindow
close_windowclose_windowCloseWindowclose_windowCloseWindowCloseWindow,
clear_drawing_objectclear_drawing_objectClearDrawingObjectclear_drawing_objectClearDrawingObjectClearDrawingObject,
detach_drawing_object_from_windowdetach_drawing_object_from_windowDetachDrawingObjectFromWindowdetach_drawing_object_from_windowDetachDrawingObjectFromWindowDetachDrawingObjectFromWindow,
get_drawing_object_iconicget_drawing_object_iconicGetDrawingObjectIconicget_drawing_object_iconicGetDrawingObjectIconicGetDrawingObjectIconic,
get_drawing_object_paramsget_drawing_object_paramsGetDrawingObjectParamsget_drawing_object_paramsGetDrawingObjectParamsGetDrawingObjectParams
create_drawing_object_rectangle1create_drawing_object_rectangle1CreateDrawingObjectRectangle1create_drawing_object_rectangle1CreateDrawingObjectRectangle1CreateDrawingObjectRectangle1,
attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindow,
detach_drawing_object_from_windowdetach_drawing_object_from_windowDetachDrawingObjectFromWindowdetach_drawing_object_from_windowDetachDrawingObjectFromWindowDetachDrawingObjectFromWindow
Foundation