DiagramControl.MeasureUnit Property

Specifies the unit of measurement to use in UI. This is a dependency property.

Assembly : DevExpress.Xpf.Diagram.v25.2.dll

NuGet Package : DevExpress.Wpf.Diagram

Declaration

C#
VB.NET

csharp

public MeasureUnit MeasureUnit { get; set; }

Public Property MeasureUnit As MeasureUnit

Property Value

Type	Description
MeasureUnit

A unit of measure.

Remarks

Set the ShowMeasureUnit property to true to display 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:

You can create a custom MeasureUnit and assign it as the MeasureUnit value.

C#
VB.NET

csharp

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");

Private Shared CentimetersStepsTable() As 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 Shared ReadOnly Centimeters As New MeasureUnit(DevExpress.XtraPrinting.GraphicsDpi.Millimeter,
    10, "Centimeters", CentimetersStepsTable, Function() "cm")