ArcScaleNeedle Class

An arc scale needle.

Namespace: DevExpress.Xpf.Gauges

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

NuGet Package: DevExpress.Wpf.Gauges

Declaration

C#

public class ArcScaleNeedle :
    ArcScaleIndicator

VB.NET

Public Class ArcScaleNeedle
    Inherits ArcScaleIndicator

Related API Members

The following members return ArcScaleNeedle objects:

• CircularGaugeHitInfo.Needle

Remarks

A needle is used to point to the current value of a circular scale. An instance of an arc scale needle is represented by the ArcScaleNeedle object. It can be accessed as an item of the ArcScaleNeedleCollection object returned by the ArcScale.Needles property.

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

For more information on needles, refer to the Needle document.

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

wpf-gauges-create-a-knob-like-gauge/CS/DXGauges_Knobs/MainWindow.xaml#L26

<dxga:ArcScale.Needles>
    <dxga:ArcScaleNeedle x:Name="needle" IsInteractive="True">
        <dxga:ArcScaleNeedle.Options>

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

<dxga:ArcScale.Needles>
    <dxga:ArcScaleNeedle x:Name="needle" Value="40" IsInteractive="True">
        <dxga:ArcScaleNeedle.Animation>

Inheritance

Object

DispatcherObject

DependencyObject

Freezable

GaugeDependencyObject

ValueIndicatorBase

ArcScaleIndicator

ArcScaleNeedle