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:

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

image\sqrblit.gif Using Annotation Bitmap Objects