ArcScale Class

An arc scale.

Namespace: DevExpress.Xpf.Gauges

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

Declaration

C#

public class ArcScale :
    Scale

VB.NET

Public Class ArcScale
    Inherits Scale

Related API Members

The following members return ArcScale objects:

• CircularGaugeHitInfo.Scale

Remarks

Arc scale is intended to be used with the CircularGaugeControl. An instance of an arc scale is represented by the ArcScale object. It can be accessed as an item of the ArcScaleCollection object returned by the CircularGaugeControl.Scales property.

An Arc Scale consists of tickmarks, labels, custom labels, ranges, layers and a spindle cap. As value indicators, it can use needles, markers and range bars.

A typical Arc Scale is shown in the image below:

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 ArcScale 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-place-one-circular-scale-into-another-e3351/VB/MainWindow.xaml#L30

<!--Day-of-week scale's start-->
<dxga:ArcScale Grid.Row="0" Grid.Column="1"
               Margin="-20, 140, 20, 0"  Height="120" Width="120"

how-to-change-an-arcscale-layout-mode-e3442/VB/CustomLabelGaugeSample/MainWindow.xaml#L26

<dxga:CircularGaugeControl.Scales>
    <dxga:ArcScale Grid.Row="0"  StartAngle="0" EndAngle="-180"
                   LayoutMode="Circle">

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

<dxga:CircularGaugeControl.Scales>
    <dxga:ArcScale>
        <dxga:ArcScale.Needles>

how-to-show-two-circular-scales-side-by-side-e3308/VB/SideBySideCircularScales/MainWindow.xaml#L21

<dxga:CircularGaugeControl.Scales>
    <dxga:ArcScale StartValue="0"   EndValue="60"
                   StartAngle="-90" EndAngle="270"

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

<dxga:CircularGaugeControl.Scales>
    <dxga:ArcScale EndValue="{Binding TargetValue}">
        <dxga:ArcScale.Needles>

Inheritance

Object

DispatcherObject

DependencyObject

Visual

UIElement

FrameworkElement

Control

GaugeElement

Scale

ArcScale

Extension Methods

GetErrorOperationCommands(Position)

GetErrorOperationCommands(Int32)

GetErrorOperationCommands(Point)