ValueIndicatorBase.Value Property

Gets or sets the value of a scale indicator.

Namespace: DevExpress.Xpf.Gauges

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

Declaration

C#

public double Value { get; set; }

VB.NET

Public Property Value As Double

Property Value

Type	Description
Double	A Double value that specifies the position of a value indicator on the scale.

Remarks

The Value property of the value indicator can be changed not only programmatically, but also by end-users via mouse-clicks. This capability becomes available after setting the ValueIndicatorBase.IsInteractive property to true. To see how this can be done in real-life examples, refer to the How to: Enable Indicator Value’s Changing via a Mouse Click tutorial.

Example

This example illustrates how to create a CircularGaugeControl instance with a single ArcScale object.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/dxgauges-getting-started-lesson-1-create-a-circular-gauge-e3199.

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 Value 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#L36

<dxga:ArcScale.Needles>
    <dxga:ArcScaleNeedle  Value="{Binding DayOfWeek}">
        <dxga:ArcScaleNeedle.Options>

dxgauges-getting-started-lesson-1-create-a-circular-gauge-e3199/VB/MainWindow.xaml#L19

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

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

<dxga:LinearScale.LevelBars>
    <dxga:LinearScaleLevelBar Value="{Binding CurrentValue}" />
</dxga:LinearScale.LevelBars>

dxgauges-getting-started-lesson-2-create-a-linear-gauge-e3254/VB/DXGauges_Linear/MainWindow.xaml#L33

<dxga:LinearScale.LevelBars>
    <dxga:LinearScaleLevelBar Value="59" />
</dxga:LinearScale.LevelBars>

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

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