ArcScale.Value Property

Gets or sets the scale’s current value.

Namespace: DevExpress.XtraGauges.Core.Model

Assembly: DevExpress.XtraGauges.v19.1.Core.dll

Declaration

C#

[Bindable(true)]
[XtraSerializableProperty(1)]
[DefaultValue(0F)]
public float Value { get; set; }

VB.NET

<Bindable(True)>
<XtraSerializableProperty(1)>
<DefaultValue(0F)>
Public Property Value As Single

Property Value

Type	Default	Description
Single	0	The scale’s current value.

Remarks

A scale’s minimum and maximum values are specified by the ArcScale.MinValue and ArcScale.MaxValue properties, respectively. Typically, you set the scale’s Value in this range. However, you can set the value beyond this range, and then correct the range to have it include the specified Value.

When you assign a value to the Value property, the value is stored in an internal variable (let’s call it internalValue). Reading the Value property returns the following values:

• internalValue, if it falls in the range [MinValue; MaxValue];
• MinValue, if internalValue is less than MinValue;
• MaxValue, if internalValue is greater than MaxValue;

Only the value returned by the Value property is persisted. This means that the internalValue is not persisted, if it falls outside the range [MinValue; MaxValue].

To get the internalValue, use the ArcScale.GetInternalValue method.

A needle (ArcScaleNeedle) linked to a scale automatically points to the scale’s current value. The current value is also indicated by a marker (ArcScaleMarker) and range bar (ArcScaleRangeBar) objects, linked to this scale.

Needle, marker and range bar objects can be linked to a scale via their ArcScale properties.

When the Value property changes, the ArcScale.ValueChanged event fires.

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-customize-the-ui-style-of-circular-gauge-e1459/CS/Form1.cs#L52

void UpdateGauge() {
    arcScale.Value = trackBar1.Value;
}

how-to-custom-draw-a-gauge-control-e3955/CS/XtraGauges_CustomDraw/Form1.cs#L65

animationLockCounter++;
arcScaleComponent1.Value = AnimateScaleValue(arcScaleComponent1, 0.05f);
animationLockCounter--;

how-to-customize-animation-e3969/CS/XtraGauge_Animation/Form1.cs#L54

void OnTimerTick(object sender, EventArgs e) {
    arcScaleComponent1.Value = AnimateScaleValue(arcScaleComponent1);
}

how-to-force-the-circulargauge-looks-like-compass-e1205/CS/WindowsApplication1/Form1.cs#L32

private void trackBarControl1_EditValueChanged(object sender, EventArgs e) {
    this.arcScaleComponent1.Value = ToAngle(trackBarControl1.Value);

how-to-use-gaugecontrol-as-an-in-place-editor-e1172/CS/InplageGaugeControl/Form1.cs#L33

int speed = (int)gridView.GetRowCellValue(e.ListSourceRowIndex, colSpeed);
circularGauge.Scales[0].Value = (float)speed;
e.Value = ((IGaugeContainer)gaugeControl).GetImage(200, 200);

VB.NET

how-to-customize-the-ui-style-of-circular-gauge-e1459/VB/Form1.vb#L56

Private Sub UpdateGauge()
    arcScale.Value = trackBar1.Value
End Sub

how-to-custom-draw-a-gauge-control-e3955/VB/XtraGauges_CustomDraw/Form1.vb#L73

animationLockCounter += 1
arcScaleComponent1.Value = AnimateScaleValue(arcScaleComponent1, 0.05F)
animationLockCounter -= 1

how-to-customize-animation-e3969/VB/XtraGauge_Animation/Form1.vb#L56

Private Sub OnTimerTick(ByVal sender As Object, ByVal e As EventArgs)
    arcScaleComponent1.Value = AnimateScaleValue(arcScaleComponent1)
End Sub

how-to-force-the-circulargauge-looks-like-compass-e1205/VB/WindowsApplication1/Form1.vb#L41

Private Sub trackBarControl1_EditValueChanged(ByVal sender As Object, ByVal e As EventArgs) Handles trackBarControl1.EditValueChanged
    Me.arcScaleComponent1.Value = ToAngle(trackBarControl1.Value)

how-to-use-gaugecontrol-as-an-in-place-editor-e1172/VB/InplageGaugeControl/Form1.vb#L38

Dim speed As Integer = CInt(Fix(gridView.GetRowCellValue(e.ListSourceRowIndex, colSpeed)))
circularGauge.Scales(0).Value = CSng(speed)
e.Value = (CType(gaugeControl, IGaugeContainer)).GetImage(200, 200)