The cross-product annotation object (AnnCrossProductObject) consists of two rulers intersecting at right angles. With the automated functions, the cross product is started on a mouse-down event and completed on a mouse-up event.
Programmatically, the points that define this crossproduct are contained in the FirstStartPoint, FirstEndPoint, SecondStartPoint, SecondEndPoint and IntersectionPoint properties. Each object has a transformation matrix associated with it. This matrix is accessed through the Transform property. The TransformObjectMode property indicates how the transform matrix will be used to transform the annotation object. The PhysicalTransform property is used to convert the logical coordinates of the points to physical coordinates. The matrix in this property is the result of multiplying the matrix in the Transform property with the matrix in the container's Transform property.
In the automation mode, it is possible to calibrate a ruler so it displays a specific length. For more information, refer to Calibrating Ruler Annotation Objects.
The AnnCrossProductObject class inherits a number of properties from the AnnDrawable class that provide support for font, pen and brush characteristics. These properties are listed below:
The name of the crossproduct object can be controlled using the following properties, inherited from the AnnObject class:
The boundaries and location of the crossproduct object can be controlled using the following properties:
Since the crossproduct 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 crossproduct object is drawn:
- GaugeLength
- MeasurementUnit
- Precision
- RulerImplemented
- ShowGauge
- ShowLength
- ShowTickMarks
- TickMarksLength
- UnitAbbreviation
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. The Container property and the Group property, both inherited from the AnnObject class, contain information on the container or the group to which the object belongs.
The following properties can also be used to programmatically set characteristics of an AnnCrossProductObject class object:
- HitTestInterior
- Hyperlink
- IsLocked
- Password
- SerializePassword
- TextColor
- UnitConverter
- UserData
- Visible
For more information about the automated crossproduct annotation object, refer to Annotation Objects - Automated Features.