ArcScale.MaxValue Property

Gets or sets the maximum value of the circular scale.

Namespace: DevExpress.XtraGauges.Core.Model

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

Declaration

C#

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

VB.NET

<DefaultValue(1F)>
<XtraSerializableProperty(0)>
Public Property MaxValue As Single

Property Value

Type	Default	Description
Single	1	A Single value that is the maximum limit of the circular scale.

Remarks

The ArcScale.MinValue and MaxValue properties together define the range of values allowed for the ArcScale. The current value indicated by the needle is specified by the ArcScale.Value property.

Note that the MaxValue property value needn’t necessarily be greater than the ArcScale.MinValue. For instance, if you switch their values, this will simply change a circular scale’s direction.

MinValue = 0, MaxValue = 100 (Default)	MinValue = 100, MaxValue = 0 (Rotated)

While the MinValue and MaxValue properties define the limit values, the number of tickmarks (and therefore labels) between them is specified by the ArcScale.MinorTickCount and ArcScale.MajorTickCount properties. The following images demonstrate how these properties can be modified together to customize the circular scale.

Default	MinValue = 0, MaxValue = 12	MinValue = 0, MaxValue = 12, MinorTickCount = 1, MajorTickCount = 13

To specify the angles where the scale starts and ends, use the ArcScale.StartAngle and ArcScale.EndAngle properties.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the MaxValue 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#L45

void OnCustomTickmarkText(CustomTickmarkTextEventArgs ea) {
    if(ea.Value == arcScale.MinValue || ea.Value == arcScale.MaxValue) return;
    ea.Result = string.Empty;

how-to-add-custom-ranges-to-the-arcscale-in-code-win-e1457/CS/Q205964/Form1.cs#L27

scale.BeginUpdate();
scale.Ranges.AddRange(CreateRanges(scale.MaxValue - scale.MinValue, scale.MinValue));
scale.EndUpdate();

VB.NET

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

Private Sub OnCustomTickmarkText(ByVal ea As CustomTickmarkTextEventArgs)
    If ea.Value = arcScale.MinValue OrElse ea.Value = arcScale.MaxValue Then
        Return

how-to-add-custom-ranges-to-the-arcscale-in-code-win-e1457/VB/Q205964/Form1.vb#L29

scale.BeginUpdate()
scale.Ranges.AddRange(CreateRanges(scale.MaxValue - scale.MinValue, scale.MinValue))
scale.EndUpdate()