ArcScaleLabelOptions Class

Contains appearance and behavior options for arc scale labels.

Namespace: DevExpress.Xpf.Gauges

Assembly: DevExpress.Xpf.Gauges.v21.2.dll

NuGet Package: DevExpress.Wpf.Gauges

Declaration

C#

public class ArcScaleLabelOptions :
    ScaleLabelOptions

VB.NET

Public Class ArcScaleLabelOptions
    Inherits ScaleLabelOptions

Related API Members

The following members return ArcScaleLabelOptions objects:

• ArcScale.LabelOptions

Remarks

Use the ArcScale.LabelOptions option to access the options that the ArcScaleLabelOptions instance provides.

To customize the arc scale label appearance, use the following options:

• ScaleLabelOptions.ShowFirst
• ScaleLabelOptions.ShowLast
• ArcScaleLabelOptions.Orientation
• ScaleLabelOptions.ZIndex

To define the scale label behavior, use the following options:

• ScaleLabelOptions.Addend
• ScaleLabelOptions.Multiplier
• ScaleLabelOptions.FormatString

Refer to the Labels (Circular Scale) document for more information about labels.

Example

This example illustrates how to create a CircularGaugeControl instance with a single ArcScale object.

View Example

MainWindow.xaml

<Window x:Class="DXGauges_Circular.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:dxga="http://schemas.devexpress.com/winfx/2008/xaml/gauges"
        Title="MainWindow" Height="350" Width="525">
    <Grid>
        <dxga:CircularGaugeControl Name="circularGaugeControl1" >
            <dxga:CircularGaugeControl.Model>
                <dxga:CircularRedClockModel />
            </dxga:CircularGaugeControl.Model>
            <dxga:CircularGaugeControl.Scales>
                <dxga:ArcScale StartValue="0" EndValue="12" 
                               StartAngle="-90" EndAngle="270"
                               MajorIntervalCount="12" MinorIntervalCount="5">
                    <dxga:ArcScale.LabelOptions>
                        <dxga:ArcScaleLabelOptions ShowFirst="False" Orientation="LeftToRight" />
                    </dxga:ArcScale.LabelOptions>
                    <dxga:ArcScale.Needles>
                        <dxga:ArcScaleNeedle Value="3" />
                        <dxga:ArcScaleNeedle Value="12" />
                    </dxga:ArcScale.Needles>
                    <dxga:ArcScale.Markers>
                        <dxga:ArcScaleMarker Value="7" />
                    </dxga:ArcScale.Markers>
                    <dxga:ArcScale.RangeBars>
                        <dxga:ArcScaleRangeBar AnchorValue="7" Value="3" />
                    </dxga:ArcScale.RangeBars>
                    <dxga:ArcScale.Layers>
                        <dxga:ArcScaleLayer />
                    </dxga:ArcScale.Layers>
                    <dxga:ArcScale.Ranges>
                        <dxga:ArcScaleRange StartValue="0" EndValue="4" />
                        <dxga:ArcScaleRange StartValue="4" EndValue="8" />
                        <dxga:ArcScaleRange StartValue="8" EndValue="12" />
                    </dxga:ArcScale.Ranges>
                </dxga:ArcScale>
            </dxga:CircularGaugeControl.Scales>
        </dxga:CircularGaugeControl>
    </Grid>
</Window>

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ArcScaleLabelOptions class.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

XAML

pivotgridcontrol-and-gaugecontrol-integration-e3332/CS/PivotGauges/MainWindow.xaml#L87

<dxga:ArcScale.LabelOptions>
    <dxga:ArcScaleLabelOptions FormatString="{}{0:C1}M" Multiplier="1E-06" Offset="-65" />
</dxga:ArcScale.LabelOptions>

Inheritance

Object

DispatcherObject

DependencyObject

Freezable

GaugeDependencyObject

ScaleLabelOptions

ArcScaleLabelOptions