Button Tool

(Document and Medical Imaging toolkits)

The button annotation object is an image of a standard Windows button that can be activated. In design mode, click and drag to specify the size of the button in the current window. Holding down the Shift key while drawing the button will make the button annotation square. A dialog box then lets the user enter the text for the button. Clicking on the button sends a WM_LTANNEVENT message that indicates an activation event. The user can add code to process the event. (The example program merely pops up a message box.)

In design mode, click on the object with the right mouse button to do the following:

• Undo the last user action.

• Cut or copy the object to the clipboard.

• Delete the object.

• Select all objects.

• Bring the object to the front or send it to the back.

• Lock and unlock annotation objects. See Password Dialog Box for Annotations.

• Change the Name properties. See Name Dialog Box for Annotations.

• Change the fill mode. See Fill Dialog Box for Annotations.

• Change the foreground and background colors. See Color Dialog Box for Annotations.

• Change the font selection and font characteristics. See Font Dialog Box for Annotations. Note: Only certain font characteristics can be changed for the button tool.

• Edit the text. See Text Dialog Box for Annotations.

• Change the fixed properties. See Fixed Dialog Box for Annotations.

• Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing Annotation Hyperlinks.

For information on flipping, reversing or rotating annotation objects, refer to Flipping, Reversing and Rotating Annotation Objects.

For low-level implementation details, refer to Button Annotation Object.