ArcScale.Needles Property

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

Namespace: DevExpress.Xpf.Gauges

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

NuGet Package: DevExpress.Wpf.Gauges

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.

View Example

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.

XAML

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

<!--region #Needles-->
<dxga:ArcScale.Needles>
    <dxga:ArcScaleNeedle x:Name="needle" IsInteractive="True">

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

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