User Interface for Container and Automation Objects

Note:

This topic is for Document/Medical only.

When using automated annotations, you can change the default properties of the user interface and the objects in the container by clicking on the container with the right mouse button. When you change the default properties, you are, in fact, changing the properties of the automation object that is associated with the container. The popup menu lets you do the following:

image\sqrblit.gif Undo the last user action.

image\sqrblit.gif Cut, copy and paste objects using the Windows clipboard.

image\sqrblit.gif Delete all selected objects.

image\sqrblit.gif Select all annotation objects in the container.

image\sqrblit.gif Arrange the layering of an object or group of objects.

image\sqrblit.gif Lock and unlock annotation objects. See Password Dialog Box for Annotations

image\sqrblit.gif Change the name properties. See Name Dialog Box for Annotations.

image\sqrblit.gif Change the default line width and style properties. See Line Dialog Box for Annotations.

image\sqrblit.gif Change the ROP2 code property. See ROP2 Dialog Box for Annotations

image\sqrblit.gif Change whether transparency is used.

image\sqrblit.gif Change the transparent color. See Color Dialog Box for Annotations.

image\sqrblit.gif Change the default fill mode and fill pattern. See Fill Dialog Box for Annotations.

image\sqrblit.gif Change the polygonal fill mode, which controls which areas are filled when lines cross. See Fill Dialog Box for Annotations.

image\sqrblit.gif Change the default foreground and background colors. See Color Dialog Box for Annotations.

image\sqrblit.gif Change the background color used by Note, Redact, or Hilite objects. See Color Dialog Box for Annotations.

image\sqrblit.gif Change the font selection and font characteristics. See Font Dialog Box for Annotations.

image\sqrblit.gif Change the Button font selection and font characteristics. See Font Dialog Box for Annotations.

image\sqrblit.gif Change the metafile to be used by Hotspot objects. See Hotspot Metafile Dialog Box for Annotations.

image\sqrblit.gif Change the metafile to be used by Encrypt objects. See Encrypt Metafile Dialog Box for Annotations.

image\sqrblit.gif Change the metafile to be used by Decrypt objects. See Decrypt Metafile Dialog Box for Annotations.

image\sqrblit.gif Change the default Ruler properties (length, gauge, tic marks, measurement units, precision). See Ruler Dialog Box for Annotations.

image\sqrblit.gif Change the node properties for objects that have nodes (whether to display the nodes and which nodes to display). See Nodes Dialog Box for Annotations.

image\sqrblit.gif Change the default Protractor properties (whether to draw the inside or outside angle, how far out to draw the angle, whether to use radians or degrees, which unit abbreviation, and precision). See Protractor Dialog Box for Annotations.

image\sqrblit.gif Change the default Point properties (whether to use a bitmap, whether to use transparency, transparent color, border color, radius, fill color, fixed size). See Point Default Properties Dialog Box for Annotations.

image\sqrblit.gif Change the default Encrypt properties (key, type (encryptor or decryptor), and location). See Encrypt Dialog Box for Annotations.

image\sqrblit.gif Change the default Fixed properties. See Fixed Dialog Box for Annotations.

image\sqrblit.gif Set and manage hyperlink properties for an object or group of objects. Note: The actual management of hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing Annotation Hyperlinks.

The default background color does not affect highlight, redaction, and note objects.

Use the L_AnnSetOptions function and the L_AnnGetOptions function 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 Multiselect

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 Annotation Features.

If the annotation objects are container, automation, text, text pointer, stamp, note, pushpin, or button objects it is possible to use the L_AnnGetTextOptions and the L_AnnSetTextOptions functions 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 functions can set the objects to show or hide the borders of the object. Note that these features must be enabled using the L_AnnSetOptions function.

The L_AnnSetFillMode and the L_AnnGetFillMode extends the original functions to support the ANNMODE_ALPHA fill mode. Before calling these two functions, enable the alpha background fill mode by calling the L_AnnSetOptions function.

Grouping and Ungrouping Annotation Objects

When using Automated annotations, if the UserMode is set to ANNUSER_DESIGN, selecting or un-selecting an object that belongs to a container which is not the root container, makes all objects from that container to be selected or unselected. This allows all objects in a sub-container to be treated as a group.

To group objects, create a container and insert the new container into the root container specifying fStripContainer = FALSE in the call to L_AnnInsert. Then, you can insert items into the sub-container to create a group. Any object that is inside the root container will be treated as an individual object when using Automated annotations. This is done automatically for you when using Automated annotations and the user selects Group or Ungroup from the automation menu.

Disabling Automation Menu Items

When you call L_AnnSetAutoText, if you pass an empty string, the menu item defined by uItem will be disabled and removed from the automation menu. To re-enable the menu item, you must call L_AnnSetAutoText and pass a valid string.

For low-level implementation details, refer to Container Annotation Object and Annotation Automation Object.