ArcScaleRange Class

An arc scale range.

Namespace: DevExpress.Xpf.Gauges

Assembly: DevExpress.Xpf.Gauges.v19.1.dll

Declaration

C#

public class ArcScaleRange :
    RangeBase

VB.NET

Public Class ArcScaleRange
    Inherits RangeBase

Related API Members

The following members return ArcScaleRange objects:

• CircularGaugeHitInfo.Range

Remarks

A range is used to mark intervals on a circular scale. An instance of an arc scale range is represented by the ArcScaleRange object. It can be accessed as an item of the ArcScaleRangeCollection object returned by the ArcScale.Ranges property.

A typical arc scale range is shown in the image below:

For more information on ranges, refer to the Range document.

Example

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

Note

A complete sample project is available at https://github.com/DevExpress-Examples/dxgauges-getting-started-lesson-1-create-a-circular-gauge-e3199.

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 snippets (auto-collected from DevExpress Examples) contain references to the ArcScaleRange 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.

C#

how-to-determine-whether-an-indicators-value-falls-into-a-particular-range-e3328/CS/MainWindow.xaml#L24

<dxga:ArcScale.Ranges>
    <dxga:ArcScaleRange StartValue="10" EndValue="30"
                        IndicatorEnter="GreenRange_IndicatorEnter"

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

<dxga:ArcScale.Ranges>
    <dxga:ArcScaleRange EndValue="100%" StartValue="80%">
        <dxga:ArcScaleRange.Presentation>

dxgauges-getting-started-lesson-1-create-a-circular-gauge-e3199/VB/MainWindow.xaml#L32

<dxga:ArcScale.Ranges>
    <dxga:ArcScaleRange StartValue="0" EndValue="4" />
    <dxga:ArcScaleRange StartValue="4" EndValue="8" />

how-to-integrate-a-state-indicator-with-the-circular-gauge-control-e3798/VB/WpfApplication1/MainWindow.xaml#L18

<dxga:ArcScale.Ranges>
    <dxga:ArcScaleRange EndValue="100" StartValue="0" />
    <dxga:ArcScaleRange EndValue="140" StartValue="100" />

Inheritance

Object

DispatcherObject

DependencyObject

Freezable

GaugeDependencyObject

LayerBase

RangeBase

ArcScaleRange

Extension Methods

GetErrorOperationCommands(Position)

GetErrorOperationCommands(Int32)

GetErrorOperationCommands(Point)