DiagramControl.MeasureUnit Property

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

Namespace: DevExpress.Xpf.Diagram

Assembly: DevExpress.Xpf.Diagram.v24.1.dll

NuGet Package: DevExpress.Wpf.Diagram

Declaration

C#

public MeasureUnit MeasureUnit { get; set; }

VB.NET

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:

• Pixels (default)
• Inches
• Millimeters

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

C#

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

VB.NET

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