SmartUnit property (ILEADRasterAnnotation)

Visual Basic example

Visual C++ 5.0 example

Syntax

long SmartUnit (long Index);

Overview

Refer to Implementing Annotations.

Remarks

(Read Only) Gets an array of values that represents the unit of measure for each ruler length in the Distance property. This property is updated by the AnnGetDistance2 method. Possible values are:

ANN_UNIT_INCHES

0

ANN_UNIT_FEET

1

ANN_UNIT_YARDS

2

ANN_UNIT_MICROMETERS

3

ANN_UNIT_MILLIMETERS

4

ANN_UNIT_CENTIMETERS

5

ANN_UNIT_METERS

6

ANN_UNIT_TWIPS

7

ANN_UNIT_POINTS

8

ANN_UNIT_PIXELS

9

Please note that if RulerUnit (i) is ANN_UNIT_SMART_METRIC or ANN_UNIT_SMART_ENGLISH, then the actual unit of measure for the ruler length in Distance (i) can be found in SmartUnit (i). If RulerUnit (i) is not ANN_UNIT_SMART_METRIC or ANN_UNIT_SMART_ENGLISH, then both RulerUnit (i) and SmartUnit (i) contain the unit of measure.

A "smart unit" is a unit that can be automatically promoted to the next higher unit.

For example, suppose you have a ruler that is 13 inches long. If the units of the ruler are ANN_UNIT_INCHES, then the length is 13. However, if the units of the ruler are ANN_UNIT_SMART_ENGLISH, then the length of the ruler is automatically promoted to feet. The length in this case would be 1.0833 feet.

See Also

Elements:

AnnGetDistance2 method, Distance property, TotalDistance property, TotalRulerUnit property, TotalSmartUnit property, RulerUnit property, DistanceCount property

Topics:

Annotations (Document/Medical only): Object Manipulation

 

Using Rulers in Annotation Objects