Back to Devexpress

ScaleLabelOptions.ShowFirst Property

wpf-devexpress-dot-xpf-dot-gauges-dot-scalelabeloptions.md

latest4.7 KB
Original Source

ScaleLabelOptions.ShowFirst Property

Gets or sets a value indicating whether the first label should be shown on a scale.

Namespace : DevExpress.Xpf.Gauges

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

NuGet Package : DevExpress.Wpf.Gauges

Declaration

csharp
public bool ShowFirst { get; set; }
vb
Public Property ShowFirst As Boolean

Property Value

TypeDescription
Boolean

true to display the first label on a scale; otherwise, false.

|

Remarks

Use the ShowFirst and ScaleLabelOptions.ShowLast properties to show or hide the first and last labels on a scale. This may be required, for example, when these labels are both displayed at the same position and the resulting gauge looks ugly. In this case, you can hide the first label by setting the ShowFirst property to false.

The table bellow illustrates the properties behavior.

ShowFirst=True, ShowLast=TrueShowFirst=False, ShowLast=TrueShowFirst=True, ShowLast=False

For more information on labels, refer to labels (Circular scale) and labels (Linear scale) documents.

Example

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

View Example

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>

See Also

ShowLast

ScaleLabelOptions Class

ScaleLabelOptions Members

DevExpress.Xpf.Gauges Namespace