In This Topic ▼

Button Annotation Object

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.

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:

Property	Defaults
Active state	Defaults to disabled. It can be changed using the L_AnnSetActiveState function.
Visible	Defaults to FALSE. It can be changed using the L_AnnSetVisible function.
Selected	Defaults to FALSE. It can be changed using the L_AnnSetSelected function.
Name	Defaults to an empty string. It can be changed using the L_AnnSetNameOptions function.
Fill mode	Defaults to transparent. It can be changed using the L_AnnSetFillMode function.
Foreground color	Defaults to red. It can be changed using the L_AnnSetForeColor function.
Background color	Defaults to white. It can be changed using the L_AnnSetBackColor 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 L_AnnSetFontSize function, the L_AnnSetFontUnderline function, the L_AnnSetFontStrikeThrough function, the L_AnnSetFontItalic function, the L_AnnSetFontBold function, and the L_AnnSetFontName function.
Text	Defaults to "AaBbYyZz". It can be changed using the L_AnnSetText function.
Text Displayed *	Defaults to Show text. It can be changed using L_AnnSetTextOptions.
Text Color *	Defaults to red (RGB(255,0,0). It can be changed using L_AnnSetTextOptions.
Expand Tokens	Defaults to expand tokens. It can be changed using the L_AnnSetTextExpandTokens function.
Name	Defaults to an empty string. It can be changed using L_AnnSetNameOptions.
Fixed State	Defaults to not fixed. It can be changed using the L_AnnSetFixed function.
Hyperlink	Defaults to None. It can be changed using the L_AnnSetHyperlink function.
Tag (identifier)	Defaults to 0. It can be changed using the L_AnnSetTag function.
Window handle	Defaults to NULL or the handle inherited from the container. It can be changed for all objects using the L_AnnSetWnd function.
User mode	Defaults to design mode or the mode inherited from the container. It can be changed for all objects using the L_AnnSetUserMode function.