ValueIndicatorBase.Value Property
Gets or sets the value of a scale indicator.
Namespace: DevExpress.Xpf.Gauges
Assembly: DevExpress.Xpf.Gauges.v24.2.dll
NuGet Package: DevExpress.Wpf.Gauges
#Declaration
#Property Value
Type | Description |
---|---|
Double | 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.
#Snap Indicator Values to Tickmarks
When users change the indicator value, they can set any value. You can prohibit users from setting values bettween tickmarks. Set the ValueIndicatorBase.SnapMode property to MajorTickmarks
/ MinorTickmarks
to snap the indicator value to major/minor tickmarks.
#Example
This example illustrates how to create a CircularGaugeControl instance with a single ArcScale object.
<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.