DiagramOptionsView.MeasureUnit Property
Specifies the unit of measurement to use in UI.
Namespace: DevExpress.XtraDiagram.Options
Assembly: DevExpress.XtraDiagram.v24.1.dll
NuGet Package: DevExpress.Win.Diagram
Declaration
[DefaultValue(typeof(MeasureUnit), "Pixels")]
[DiagramCategory(DiagramCategory.Options)]
public virtual MeasureUnit MeasureUnit { get; set; }Property Value
| Type | Default | Description |
|---|---|---|
| MeasureUnit | "Pixels" | A unit of measure. |
Property Paths
You can access this nested property as listed below:
| Object Type | Path to MeasureUnit |
|---|---|
| DiagramControl |
|
Remarks
Set the ShowMeasureUnit property to true to use the unit of measurement in the Properties Panel and Bottom Panel.
If the ShowMeasureUnit property is set to false, the MeasureUnit value only affects the ruler’s unit of measurement and values in the Page Setup Window. The Properties Panel and Bottom Panel display values in pixels.
The illustration below shows a diagram with the MeasureUnit property set to Inches.
ShowMeasureUnit = true
ShowMeasureUnit = false
The ShowRulers property specifies whether the diagram rulers are visible.
The following measurement units are available:
- Pixels (default)
- Inches
- Millimeters
You can create a custom MeasureUnit and assign it as the MeasureUnit value.
private static TickStepsData[] CentimetersStepsTable = new TickStepsData[] {
new TickStepsData(0.01, 100.0, 5, 10),
new TickStepsData(0.02, 50.0, 5, 10),
new TickStepsData(0.03, 30.0, 2, 10),
new TickStepsData(0.06, 20.0, 2, 10),
new TickStepsData(0.12, 15.0, 2, 10),
new TickStepsData(0.2, 10.0, 2, 10),
new TickStepsData(0.25, 5.0, 2, 10),
new TickStepsData(0.3, 5.0, 2, 8),
new TickStepsData(0.4, 5.0, 2, 4),
new TickStepsData(0.5, 2.5, 2, 8),
new TickStepsData(0.8, 2.0, 2, 10),
new TickStepsData(1.0, 1.0, 2, 10),
new TickStepsData(1.5, 1.0, 2, 8),
};
public static readonly MeasureUnit Centimeters =
new MeasureUnit(DevExpress.XtraPrinting.GraphicsDpi.Millimeter, 10, "Centimeters", CentimetersStepsTable, () => "cm");