RangeBase.StartValue Property

Gets or sets the start position of the range on a scale.

Namespace: DevExpress.Xpf.Gauges

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

Declaration

C#

public RangeValue StartValue { get; set; }

VB.NET

Public Property StartValue As RangeValue

Property Value

Type	Description
RangeValue	A RangeValue object that allows setting the start position of the range in either absolute or relative units.

Remarks

Use the StartValue and RangeBase.EndValue properties to specify the position of the range on a scale.

RangeValue is a complex object that allows you to set the StartValue and RangeBase.EndValue properties in different units. The RangeValue.RangeValueType property defines how to treat the RangeValue.Value property - as either an absolute value or as a percent.

The following XAML illustrates how to set this property for the range on the circular scale:

XAML

<dxga:ArcScaleRange StartValue="10" EndValue="40" />

XAML

<dxga:ArcScaleRange StartValue="25%" EndValue="75%" />

XAML

<dxga:ArcScaleRange StartValue="10" EndValue="75%" />

Note that the StartValue can be either less than the EndValue or greater than EndValue - both situations are correct.

The table below illustrates this behavior.

StartValue is less than EndValue	StartValue is greater than EndValue

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the StartValue 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-determine-whether-an-indicators-value-falls-into-a-particular-range-e3328/CS/MainWindow.xaml#L24

<dxga:ArcScale.Ranges>
    <dxga:ArcScaleRange StartValue="10" EndValue="30"
                        IndicatorEnter="GreenRange_IndicatorEnter"

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

<dxga:LinearScale.Ranges>
    <dxga:LinearScaleRange EndValue="32" StartValue="-40">
        <dxga:LinearScaleRange.Presentation>

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

<dxga:ArcScale.Ranges>
    <dxga:ArcScaleRange StartValue="0" EndValue="4" />
    <dxga:ArcScaleRange StartValue="4" EndValue="8" />

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

<dxga:ArcScale.Ranges>
    <dxga:ArcScaleRange EndValue="100" StartValue="0" />
    <dxga:ArcScaleRange EndValue="140" StartValue="100" />

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

<dxga:ArcScale.Ranges>
    <dxga:ArcScaleRange EndValue="100%" StartValue="80%">
        <dxga:ArcScaleRange.Presentation>