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.v18.2.dll

Declaration

public ArcScaleNeedleCollection Needles { get; }
Public ReadOnly Property Needles As ArcScaleNeedleCollection

Property Value

Type Description
ArcScaleNeedleCollection

An ArcScaleNeedleCollection object that contains scale needles.

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[Int32] property of an ArcScaleNeedleCollection object.

Examples

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

<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>

See Also