Protractor Annotation Object

Note:

This topic is for Document/Medical only.

The protractor annotation object (ANN_OBJECT_PROTRACTOR) consists of two simple lines joined at a vertex to create an angle. With the automated functions, the first line of the protractor is started on a mouse-down event and completed on a second mouse-down event. The second line is completed on a third mouse-down event.

For information on flipping, reversing or rotating annotation objects, refer to Flipping, Reversing and Rotating Annotation Objects.

With low-level functions, you must define the size and position of the 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.

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.

Ruler show flags

Defaults to not show the Length, the Gauge or the Tic Marks. These options can be changed using the AnnSetShowFlags method, the AnnSetGaugeLength method, and the AnnSetUnit method.

Protractor

Defaults to displaying the inside (acute) angle, measured in degrees, to a precision of two places right of the decimal, and an arc radius of 30. These settings can be changed using the AnnSetProtractorOptions method. To retrieve the current values, use the AnnGetProtractorOptions 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.

To get the angle of the Protractor object in the object's unit of measurement, use AnnGetAngle method

Related topics:

Implementing Annotations

Types of Annotations

Low-Level Coordinate System for Annotations

Using Rulers in Annotation Objects