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::SetFillModeExt function. For version 14.5, 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.

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

Related topics:

image\sqrblit.gif Implementing Annotations.

image\sqrblit.gif Types of Annotations.

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