Container Annotation Object

Note:

This topic is for Document/Medical only.

The container annotation object (ANN_OBJECT_CONTAINER) is a rectangle that is normally transparent, with a NULL line style. With the automated functions, its only purpose is to group other objects, including other container objects.

With low-level functions, you can insert and remove objects from a container, and you must specify the coordinates of an object relative to the container that it is in. The outermost (root) container establishes the frame of reference for all other objects, as explained in Low-Level Coordinate System for Annotations.

With low-level functions, you must specify the defining rectangle. Other applicable properties for the container 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 .
Foreground color	Defaults to black. It can be changed using the AnnSetForeColor method.
Background color	Defaults to white. It can be changed using the AnnSetBackColor method.
Name	Defaults to empty string. It can be changed using AnnSetNameOptions.
Line width	Defaults to 1. It can be changed using the AnnSetLineWidth method. (Values equate to a minimum of 1 pixel when displayed.)
Line style	Defaults to NULL. It can be changed using the AnnSetLineStyle 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 AnnSetFillMode 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. To retrieve its value, use the AnnGetWnd 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 .
Fixed State	Defaults to not fixed. It can be changed using the AnnFixed property

Use the AnnSetOptions method and the AnnGetOptions method to control the following features:

$image\sqrblit.gif$ Rubber Stamp Display Style

$image\sqrblit.gif$ XP Style Annotation Toolbar

$image\sqrblit.gif$ Alpha Background Fill Option

$image\sqrblit.gif$ Annotation Rotate Option

$image\sqrblit.gif$ Annotation Side Handles

$image\sqrblit.gif$ Annotation Multi-select

$image\sqrblit.gif$ Annotation Cursors

$image\sqrblit.gif$ ESC to Cancel

$image\sqrblit.gif$ Calibrate Ruler Feature

$image\sqrblit.gif$ Dot Dash Lines

$image\sqrblit.gif$ Text Annotation Options

For more information about these features, refer to New Annotation Features of Version 14.5.

If the annotation objects are container, automation, text, text pointer, stamp, note, pushpin, or button objects it is possible to use the AnnGetTextOptions method and the AnnSetTextOptions method to set the objects to show or hide the text and to set the color of the text. In addition, if the annotation objects are text or stamp objects these methods can set the objects to show or hide the borders of the object. In version 14.5, note that these features must be enabled using the AnnSetOptions method.

Use the AnnSetFillMode method and the AnnGetFillMode method to manage the fill mode used by annotation objects. The AnnSetFillModeExt method and the AnnGetFillModeExt method extends the original methods to support the ANN_FILLMODE_ALPHA fill mode. Before calling these two methods, enable the alpha background fill mode by calling the AnnSetOptions method.