AnnProtractorObject Object

The protractor annotation object consists of two rulers joined at a point to create an angle. The center point is CenterPoint, the first line ends at FirstPoint and the second point ends at SecondPoint.

With the automated functions, the first line of the protractor is started on a click or tap event and completed on a second click or tap event. The second line is completed on a third click or tap event.

With the automated functions, on systems with touch support, the first line segment starts with the first tap and hold. Each successive tap and hold for 1.5 seconds results in a new line segment. The object is completed by the user removing the finger from the device.

Programmatically, the boundaries and location of the protractor object can be controlled using the following properties:

• AnnObject.Bounds
• Points
• CenterPoint
• FirstPoint
• SecondPoint

Each object can be transformed with the following methods:

• Scale
• Translate
• Rotate

The AnnProtractorObject class inherits a number of properties from the AnnObject class, providing support for font, stroke and fill characteristics. These properties are listed below:

• Fill
• Stroke
• Font
• AnnObject.SupportsFill
• AnnObject.SupportsStroke
• AnnObject.SupportsFont

The name of the protractor object can be controlled using Labels property, inherited from the AnnObject class.

An object can be part of a group annotation object or part of a container object. It cannot be part of both a group and a container at the same time.

Since the annotation protractor object consists of two rulers, it has certain ruler characteristics pertaining to the length, tick marks and gauge. The following properties may be used to customize these ruler characteristics and determine what exactly is displayed when the cross-product object is drawn:

• TickMarksStroke
• TickMarksLength
• ShowTickMarks
• MeasurementUnit
• UnitsAbbreviation
• GaugeLength
• ShowGauge
• Precision

The following properties can also be used to programmatically set characteristics of an AnnProtractorObject:

• Acute
• AngularUnit
• AngularUnitsAbbreviation
• AnglePrecision
• ArcRadius
• Hyperlink
• IsLocked
• Password
• IsVisible

This example creates a protractor object and adds it to the automation container.

example: function SiteLibrary_DefaultPage$example() {
   // assumes _automation is valid
   var inch = 720.0;
   // Add a protractor object
   var protractorObj = new lt.Annotations.Core.AnnProtractorObject();
   // Set the points for the protractor
   protractorObj.set_firstPoint(lt.LeadPointD.create(5 * inch, 1 * inch));
   protractorObj.set_centerPoint(lt.LeadPointD.create(1 * inch, 3 * inch));
   protractorObj.set_secondPoint(lt.LeadPointD.create(5 * inch, 5 * inch));
   // Set the radius
   protractorObj.set_arcRadius(lt.LeadLengthD.create(350));
   // Add the object to the automation container
   this._automation.get_container().get_children().add(protractorObj);
   // Select the object
   this._automation.selectObject(protractorObj);
},