The ruler annotation object (AnnRulerObject) is a simple line with gauges on both ends for measuring distance. With the automated functions, the ruler is started on a mouse-down event and completed on a mouse-up event.
Programmatically, the boundaries and location of the ruler object can be controlled using the following properties:
The AnnRulerObject class inherits a number of properties from the AnnObjectBase class that provide support for font, pen and brush characteristics. These properties are listed below:
Fill Stroke StrokeDashArray StrokeDashCap StrokeDashOffset StrokeEndLineCap StrokeLineJoin StrokeMiterLimit StrokeStartLineCap StrokeThickness FontDecorations FontFamily FontSize FontStretch FontStyle FontWeight SupportsFill SupportsFont SupportsStroke
The name of the ruler object can be controlled using the following properties, inherited from the AnnObjectBase class:
Header HeaderBackground HeaderDecorations HeaderFontFamily HeaderFontSize HeaderFontStretch HeaderFontStyle HeaderFontWeight HeaderForeground HeaderOffset IsHeaderRestricted IsHeaderVisible
The following properties may be used in transforming a ruler annotation object:
The AnnRulerObject class implements the IAnnRulerObject interface. This interface provides a number of ruler properties that control certain aspects of the rulers themselves and indicate which characteristics will be displayed on the ruler. These properties are listed below:
GaugeLength MeasurementUnit Precision IsRulerImplemented 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 AnnObjectBase 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 AnnRulerObject class object:
For more information about the automated ruler annotation object, refer to WPF Annotation Objects - Automated Features and WPF Automated Annotations - Ruler Tab.