Stamp Annotation Object
Note: |
This topic is for Document/Medical only. |
The Stamp annotation object (ANN_OBJECT_STAMP) can be a bitmap image, a metafile, or a text string in a rectangular frame. Only one of these three can be displayed at any time—setting the object to one of these destroys any settings for the other two. Initially, the ANN_OBJECT_STAMP displays text. With the automated functions, the user clicks and drags to specify a rectangle. Then, if the user specifies a text string, the text is centered in the rectangle. If the user specifies a bitmap, the bitmap is scaled to fit the rectangle.
On a device that displays 256 colors or less, you should use a fixed palette when displaying bitmaps. Otherwise, a palette shift will occur on stamp objects containing bitmaps.
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:
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. |
Line width |
Defaults to 0.75 points. It can be changed using the AnnSetLineWidth method. (Note that when displayed, the line must have a minimum width of 1 pixel.) |
Line style |
Defaults to solid. It can be changed using the AnnSetLineStyle method. |
ROP2 code |
Defaults to ANN_ROP2_COPY. It can be changed using the AnnSetROP2 method. |
Transparent option |
Defaults To Do Not Use Transparent Color. It can be changed using the AnnSetTransparent method. |
Transparent Color |
Defaults to White. It can be changed using the AnnSetTransparentColor method. |
Fill pattern |
Defaults to solid. It can be changed using the AnnSetFillPattern method. |
Fill mode |
Defaults to transparent. It can be changed using the AnnSetFillModeExt method. For version 14.5, before calling this method enable the alpha background fill mode by calling the AnnSetOptions 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. The default does not affect highlight, redaction, or note objects. |
Font size |
Defaults to 10 point, translated with a scaling factor of 1. It can be changed using the AnnSetFontSize method. |
Font underline |
Defaults to FALSE. It can be changed using the AnnSetFontUnderline method. |
Font strikethrough |
Defaults to FALSE. It can be changed using the AnnSetFontStrikeThrough method. |
Font italic |
Defaults to FALSE. It can be changed using the AnnSetFontItalic method. |
Font bold |
Defaults to FALSE. It can be changed using the AnnSetFontBold method. |
Font name |
Defaults to "Arial". It can be changed using the AnnSetFontName method. |
Font size |
Defaults to 10 point, translated with a scaling factor of 1. It can be changed using the AnnSetFontSize method. |
Text Displayed* |
Defaults to Show text. It can be changed using AnnSetTextOptions method. |
Text Color* |
Defaults to red (RGB(255,0,0). It can be changed using AnnSetTextOptions. |
Text Border* |
Defaults to show the Border. It can be changed using AnnSetTextOptions. |
Expand Tokens |
Defaults to expand tokens. It can be changed using the AnnTextExpandTokens property. |
Bitmap |
Defaults to Empty. It can be changed using the AnnSetBitmap method. |
Metafile |
Defaults to Empty. It can be changed using the AnnSetMetafile method. |
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. |
* Note that in version 14.5, these features must be enabled using the AnnSetOptions method.
Related topics:
Low-Level Coordinate System for Annotations.