End users can create a mark using the ART toolbar, or your application can create them directly by calling ART functions. This section describes how to create marks with user interaction through the ART toolbar.

When a button is selected from the toolbar, ART goes into "edit mode", where the mouse is used to place and size the mark. The sequence of events depends on whether the mark is one of the types that contains text or not:

If the mark does not contain text:

• The user drags a rectangle on the image.
• The mark is placed and sized on the image, and is selected.
• Control returns to the application.

If the mark contains text:

• The user drags a rectangle on the image.
• The mark is placed and sized on the image, and is placed in text-edit mode.
• The blinking "I-Beam" insertion point is placed in the mark.
• The user types text into the mark, as desired.
• The user clicks the mouse-button, and the mark goes from text-edit mode to selected mode.
• Control returns to the application.

Note that ART Toolbar event handlers are implemented in the ART GUI open source code and can be modified at any time and any way, but in order for them to work, your application needs to interact with the following events:

• IG_ARTX_GUI_mouse_down
• IG_ARTX_GUI_mouse_move
• IG_ARTX_GUI_mouse_up