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.

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 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_AnnSetFillModeExt 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.

* Note that in version 14.5, these features must be enabled using the L_AnnSetOptions function.

Related topics:

image\sqrblit.gif Implementing Annotations.

image\sqrblit.gif Types of Annotations.

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

image\sqrblit.gif Annotation Objects - Automated Features