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 sends a WM_LTANNEVENT message that indicates an activation event.

The class for Button Annotation objects is LAnnButton.

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

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

Active state	Defaults to disabled. It can be changed using the LAnnotation::SetActiveState function.
Visible	Defaults to FALSE. It can be changed using the LAnnotation::SetVisible function.
Selected	Defaults to FALSE. It can be changed using the LAnnotation::SetSelected function.
Name	Defaults to an empty string. It can be changed using the LAnnotation::SetNameOptions function.
Fill mode	Defaults to transparent. It can be changed using the LAnnAutomation::SetFillMode function.
Foreground color	Defaults to red. It can be changed using the LAnnButton::SetForeColorfunction.
Background color	Defaults to white. It can be changed using the LAnnAutomation::SetBackColor function. The default does not affect highlight, redaction, or note objects.
Font	Defaults to a regular MS Sans Serif red font at 10 points. It can be changed using the LAnnotation::SetFontSize function, the LAnnotation::SetFontUnderline function, the LAnnotation::SetFontStrikethrough function, the LAnnotation::SetFontItalic function, the LAnnotation::SetFontBold function, and the LAnnotation::SetFontName function.
Button Font	Defaults to a regular MS Sans Serif red font at 10 points.
Text	Defaults to "AaBbYyZz". It can be changed using the LAnnButton::SetText function.
Text Displayed*	Defaults to Show text. It can be changed using LAnnotation::SetTextOptions.
Text Color*	Defaults to red (RGB(255,0,0). It can be changed using LAnnotation::SetTextOptions.
Expand Tokens	Defaults to expand tokens. It can be changed using the LAnnAutomation::SetTextExpandTokens function.
Name	Defaults to an empty string. It can be changed using the LAnnotation::SetNameOptions function.
Fixed State	Defaults to not fixed. It can be changed using the LAnnXXX::SetFixed function.
Hyperlink	Defaults to ANNLINK_NONE. It can be changed using the LAnnotation::SetHyperlink function.
Tag (identifier)	Defaults to 0. It can be changed using the LAnnotation::SetTag function.
Window handle	Defaults to NULL or the handle inherited from the container. It can be changed for all objects using LAnnContainer::SetWnd.
User mode	Defaults to design mode or the mode inherited from the container. It can be changed for all objects using LAnnContainer::SetUserMode.

* These features must be enabled using the LAnnotation::SetOptions function.