Changing the Annotation Automation Background Colors

Note:

This topic is for Document/Medical only.

When working with automated annotations, the background color of most objects created by a particular automation object can be changed by calling the AnnSetBackColor method for that automation object. However, the Note (ANNOBJECT_NOTE), Push-pin (ANNOBJECT_PUSHPIN), Redact (ANNOBJECT_REDACT) and Hilite (ANNOBJECT_HILITE) objects cannot be changed using this function and must be handled differently.

The automation object (ANNOBJECT_AUTOMATION) contains four background color values:

$image\sqrblit.gif$ one color for the Note and Push-pin objects

$image\sqrblit.gif$ one color for the Hilite object

$image\sqrblit.gif$ one color for the Redact object

$image\sqrblit.gif$ one color for all other objects

When the automation object creates an object, it uses the corresponding background color. For example, if the automation object creates a Redact object, it uses the color stored for Redact objects. If the background for an object type is changed using the automation, the corresponding background color value stored for that object type is updated. Consequently, the next time the automation object creates an object of that type, the updated background color is used.

To change the background colors stored in the automation object:

$image\sqrblit.gif$ right click with no objects selected. All the default properties for objects created by the automation object can then be changed.

$image\sqrblit.gif$ call the AnnSetAutoBackColor method. This lets you programmatically change the background color of objects created by the automation object.

To determine the current background colors stored within the automation object, use the AnnGetAutoBackColor method.