MeasureUnit Class

Represents a unit of measure used by the XtraDiagram.DiagramControl and Xpf.Diagram.DiagramControl.

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

NuGet Package: DevExpress.Diagram.Core

Declaration

C#
VB.NET

[TypeConverter(typeof(MeasureUnitConverter))]
public class MeasureUnit

<TypeConverter(GetType(MeasureUnitConverter))>
Public Class MeasureUnit

The following members return MeasureUnit objects:

Library	Related API Members
WinForms Controls	DiagramOptionsView.MeasureUnit
WPF Controls	DiagramControl.MeasureUnit

Remarks

Use the corresponding properties to specify the measure unit used by the DiagramControl:

WPF: DiagramControl.MeasureUnit
Winforms: DiagramOptionsView.MeasureUnit

The following measurement units are available:

The code snippet below demonstrates how to define TickStepsData for a custom MeasureUnit:

C#
VB.NET

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