ArcScale.Needles Property

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

Namespace: DevExpress.Xpf.Gauges

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

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 to 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 GaugeDependencyObjectCollectionBase<T>.Item property of an ArcScaleNeedleCollection object.

Example

The following example demonstrates how to customize the needle on a circular scale.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-create-a-knob-like-gauge-e3335.

XAML

<dxga:ArcScale.Needles>
    <dxga:ArcScaleNeedle x:Name="needle" IsInteractive="True">
        <dxga:ArcScaleNeedle.Options>
            <dxga:ArcScaleNeedleOptions EndOffset="10" />
        </dxga:ArcScaleNeedle.Options>
        <dxga:ArcScaleNeedle.Presentation>
            <dxga:CustomArcScaleNeedlePresentation
                NeedleTemplate="{StaticResource OscilloscopeNeedleTemplate}" />
        </dxga:ArcScaleNeedle.Presentation>
    </dxga:ArcScaleNeedle>
</dxga:ArcScale.Needles>

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Needles property.

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

           MajorIntervalCount="7" ShowMinorTickmarks="False" >
<dxga:ArcScale.Needles>
    <dxga:ArcScaleNeedle  Value="{Binding DayOfWeek}">

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

<dxga:ArcScale>
    <dxga:ArcScale.Needles>
        <dxga:ArcScaleNeedle IsInteractive="True" />

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

           MajorIntervalCount="12">
<dxga:ArcScale.Needles>
    <dxga:ArcScaleNeedle Value="15" />

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

<dxga:ArcScale EndValue="{Binding TargetValue}">
    <dxga:ArcScale.Needles>
        <dxga:ArcScaleNeedle Value="{Binding TotalValue}" IsInteractive="True">

how-to-display-tooltips-for-gauge-elements-e3406/CS/DXGauges_ShowTooltips/MainWindow.xaml#L23

<dxga:ArcScale>
    <dxga:ArcScale.Needles>
        <dxga:ArcScaleNeedle IsInteractive="True"