Stamp Annotation Object
Note: |
This topic is for Document/Medical only. |
The Stamp annotation object (ANNOBJECT_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 ANNOBJECT_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.
The class for Stamp Annotation objects is LAnnStamp.
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 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. |
Line width |
Defaults to 0.75 points. It can be changed using the LAnnXXX::SetLineWidth function. (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 LAnnXXX::SetLineStyle function. |
ROP2 code |
Defaults to ANNROP2_COPY. It can be changed using the LAnnotation::SetROP2 function. |
Transparent option |
Defaults To Do Not Use Transparent Color. It can be changed using the LAnnStamp::SetTransparent function. |
Transparent Color |
Defaults to White. It can be changed using the LAnnStamp::SetTransparentColor function. |
Fill pattern |
Defaults to solid. It can be changed using the LAnnAutomation::SetFillPattern function. |
Fill mode |
Defaults to transparent. It can be changed using the LAnnotation::SetFillMode function. Before calling this function enable the alpha background fill mode by calling the LAnnotation::SetOptions function. |
Foreground color |
Defaults to red. It can be changed using the LAnnotation::SetForeColor function. |
Background color |
Defaults to white. It can be changed using the LAnnXXX::SetBackColor function. |
Font size |
Defaults to 10 point, translated with a scaling factor of 1. It can be changed using the LAnnXXX::SetFontSize function. |
Font underline |
Defaults to FALSE. It can be changed using the LAnnXXX::SetFontUnderline function. |
Font strikethrough |
Defaults to FALSE. It can be changed using the LAnnXXX::SetFontStrikethrough function. |
Font italic |
Defaults to FALSE. It can be changed using the LAnnXXX::SetFontItalic function. |
Font bold |
Defaults to FALSE. It can be changed using the LAnnXXX::SetFontBold function. |
Font name |
Defaults to "Arial". It can be changed using the LAnnXXX::SetFontName function. |
Text |
Defaults to "AaBbYyZz". It can be changed using the LAnnStamp::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. |
Text Border* |
Defaults to show the Border. It can be changed using LAnnotation::SetTextOptions. |
Expand Tokens |
Defaults to expand tokens. It can be changed using the LAnnAutomation::SetTextExpandTokens function. |
Bitmap |
Defaults to Empty. It can be changed using the LAnnStamp::SetBitmap function. |
Metafile |
Defaults to Empty. It can be changed using the LAnnStamp::SetMetafile 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.
Related topics: