Button Annotation Object

Note:

This topic is for Document/Medical only.

The button annotation object (ANNOBJECT_BUTTON) is an image of a standard Windows button that can be activated. With the automated functions, the user clicks and drags to specify the rectangle in the current window. A dialog box then lets the user enter the text for the button. In run mode, clicking on the button triggers an AnnClicked event.

You cannot flip, reverse, or rotate a button. If you flip, reverse, or rotate a container that includes a button, the button will move to the new position, but will retain its orientation.

With low-level functions, you must specify the defining rectangle. Other applicable properties have the following defaults, which you can change:

Visible

Defaults to FALSE. It can be changed using the AnnSetVisible method.

Selected

Defaults to FALSE. It can be changed using the AnnSetSelected method.

Name

Defaults to an empty string. It can be changed using the AnnSetNameOptions method.

Fill mode

Defaults to transparent. It can be changed using the AnnSetFillMode method.

Foreground color

Defaults to red. It can be changed using the AnnSetForeColor method.

Background color

Defaults to white. It can be changed using the AnnSetBackColor method.

Font

Defaults to a regular MS Sans Serif red font at 10 points. It can be changed using the AnnSetFontSize method, the AnnSetFontUnderline method, the AnnSetFontStrikeThrough method, the AnnSetFontItalic method, the AnnSetFontBold method, and the AnnSetFontName method.

Text

Defaults to "AaBbYyZz". It can be changed using the AnnSetText method.

Expand Tokens

Defaults to expand tokens. It can be changed using the AnnTextExpandTokens property.

Fixed State

Defaults to not fixed. It can be changed using the AnnFixed property.

Hyperlink

Defaults to None. It can be changed using the AnnSetHyperlinkString method.

Tag (identifier)

Defaults to 0. It can be changed using the AnnSetTag method.

Window handle

Defaults to NULL or the handle inherited from the container. It can be changed for all objects using the AnnSetWnd method.

User mode

Defaults to design mode or the mode inherited from the container. It can be changed for all objects using the AnnUserMode property.

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

Related topics:

image\sqrblit.gif Implementing Annotations.

image\sqrblit.gif Types of Annotations.

image\sqrblit.gif Low-Level Coordinate System for Annotations.