set_drawing_object_xldset_drawing_object_xldSetDrawingObjectXldSetDrawingObjectXld (Operator)

Name

set_drawing_object_xldset_drawing_object_xldSetDrawingObjectXldSetDrawingObjectXld — Set the contour of an interactive draw XLD.

Signature

Description

set_drawing_object_xldset_drawing_object_xldSetDrawingObjectXldSetDrawingObjectXldSetDrawingObjectXld substitutes the XLD currently contained in the draw object by the new ContourContourContourContourcontour. The contour must contain at least two points, so that the interaction as described in create_drawing_object_xldcreate_drawing_object_xldCreateDrawingObjectXldCreateDrawingObjectXldCreateDrawingObjectXld is possible.

In addition, if the drawing object DrawIDDrawIDDrawIDDrawIDdrawID is currently attached to a HALCON window, the window will be redrawn with each call of set_drawing_object_xldset_drawing_object_xldSetDrawingObjectXldSetDrawingObjectXldSetDrawingObjectXld.

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

Result

set_drawing_object_xldset_drawing_object_xldSetDrawingObjectXldSetDrawingObjectXldSetDrawingObjectXld returns 2 (H_MSG_TRUE), if the DrawIDDrawIDDrawIDDrawIDdrawID is valid and ContourContourContourContourcontour is a contour consisting of at least two points. If necessary, an exception is raised.

Possible Predecessors

create_drawing_object_xldcreate_drawing_object_xldCreateDrawingObjectXldCreateDrawingObjectXldCreateDrawingObjectXld

Possible Successors

attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindowAttachDrawingObjectToWindow, clear_drawing_objectclear_drawing_objectClearDrawingObjectClearDrawingObjectClearDrawingObject

Alternatives

create_drawing_object_xldcreate_drawing_object_xldCreateDrawingObjectXldCreateDrawingObjectXldCreateDrawingObjectXld

See also

attach_drawing_object_to_windowattach_drawing_object_to_windowAttachDrawingObjectToWindowAttachDrawingObjectToWindowAttachDrawingObjectToWindow

Module

Foundation