ArcScale.Needles Property

Provides access to a collection of needles contained in the current Circular Scale.

Namespace: DevExpress.UI.Xaml.Gauges

Assembly: DevExpress.UI.Xaml.Gauges.v21.2.dll

NuGet Package: DevExpress.Uwp.Controls

Declaration

C#

public ArcScaleNeedleCollection Needles { get; }

VB.NET

Public ReadOnly Property Needles As ArcScaleNeedleCollection

Property Value

Type	Description
ArcScaleNeedleCollection	An ArcScaleNeedleCollection object that contains scale needles.

Remarks

Use the Needles property to add or remove needles from the current scale, as well as to customize different settings of individual scale needles. A single needle is an instance of the ArcScaleNeedle class and can be accessed via the Item[] property of an ArcScaleNeedleCollection object.

Example

The following example demonstrates how to create a Circular Gauge with two needles, three ranges, one marker and one range bar.

XAML

<Page
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="using:CircularGaugeLesson"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    xmlns:Gauges="using:DevExpress.UI.Xaml.Gauges"
    x:Class="CircularGaugeLesson.MainPage"
    mc:Ignorable="d">

    <Grid Background="{StaticResource ApplicationPageBackgroundThemeBrush}">

        <Gauges:CircularGauge>
            <Gauges:ArcScale StartValue="0" EndValue="12"
                             StartAngle="-90" EndAngle="270"
                             MajorIntervalCount="12" MinorIntervalCount="5">
                <Gauges:ArcScale.Ranges>
                    <Gauges:ArcScaleRange StartValue="0" EndValue="4"/>
                    <Gauges:ArcScaleRange EndValue="8" StartValue="4"/>
                    <Gauges:ArcScaleRange EndValue="12" StartValue="8"/>
                </Gauges:ArcScale.Ranges>
                <Gauges:ArcScale.RangeBars>
                    <Gauges:ArcScaleRangeBar AnchorValue="7" Value="3"/>
                </Gauges:ArcScale.RangeBars>
                <Gauges:ArcScale.Markers>
                    <Gauges:ArcScaleMarker Value="7"/>
                </Gauges:ArcScale.Markers>
                <Gauges:ArcScale.Needles>
                    <Gauges:ArcScaleNeedle Value="3"/>
                    <Gauges:ArcScaleNeedle Value="12"/>
                </Gauges:ArcScale.Needles>
                <Gauges:ArcScale.LabelOptions>
                    <Gauges:ArcScaleLabelOptions ShowFirst="False"/>
                </Gauges:ArcScale.LabelOptions>
            </Gauges:ArcScale>
        </Gauges:CircularGauge>

    </Grid>
</Page>