Class CircularScale

It contains collection of ranges, pointers, labels, and ticks that help to visualize the data.

Inheritance

System.Object

CircularScale

Implements

System.IDisposable

Namespace: Syncfusion.UI.Xaml.Gauges

Assembly: Syncfusion.SfGauge.UWP.dll

Syntax

public class CircularScale : Control, IDisposable

Constructors

CircularScale()

Initializes a new instance of the CircularScale class.

Declaration

public CircularScale()

Remarks

New instance of the CircularRangeCollection, CircularPointerCollection, CircularScaleTickCollection, CircularScaleLabelCollection classes are initialized.

Fields

BindRangeStrokeToLabelsProperty

Declaration

public static readonly DependencyProperty BindRangeStrokeToLabelsProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

BindRangeStrokeToTicksProperty

Declaration

public static readonly DependencyProperty BindRangeStrokeToTicksProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

CustomLabelsProperty

Using a DependencyProperty as the backing store for CustomLabels. This enables animation, styling, binding, etc...

Declaration

public static readonly DependencyProperty CustomLabelsProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

EnableAutoAngleProperty

The DependencyProperty for EnableAutoAngle property.

Declaration

public static readonly DependencyProperty EnableAutoAngleProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

EnableAutoIntervalProperty

Declaration

public static readonly DependencyProperty EnableAutoIntervalProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

EnableSmartLabelsProperty

Declaration

public static readonly DependencyProperty EnableSmartLabelsProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

EndPointProperty

Declaration

public static readonly DependencyProperty EndPointProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

EndValueProperty

Declaration

public static readonly DependencyProperty EndValueProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

IntervalProperty

Declaration

public static readonly DependencyProperty IntervalProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

IsLogarithmicProperty

Declaration

public static readonly DependencyProperty IsLogarithmicProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

IsLogLabelSuperscriptEnabledProperty

Declaration

public static readonly DependencyProperty IsLogLabelSuperscriptEnabledProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

LabelAutoSizeChangeProperty

Declaration

public static readonly DependencyProperty LabelAutoSizeChangeProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

LabelOffsetProperty

Declaration

public static readonly DependencyProperty LabelOffsetProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

LabelPositionProperty

Declaration

public static readonly DependencyProperty LabelPositionProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

LabelPostfixProperty

Declaration

public static readonly DependencyProperty LabelPostfixProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

LabelPrefixProperty

Declaration

public static readonly DependencyProperty LabelPrefixProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

LabelStrokeProperty

Declaration

public static readonly DependencyProperty LabelStrokeProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

LogBaseProperty

Declaration

public static readonly DependencyProperty LogBaseProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

LogExponentIntervalProperty

Declaration

public static readonly DependencyProperty LogExponentIntervalProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

MajorTickEndOffsetProperty

Declaration

public static readonly DependencyProperty MajorTickEndOffsetProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

MajorTickOffsetProperty

Declaration

public static readonly DependencyProperty MajorTickOffsetProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

MajorTickStartOffsetProperty

Declaration

public static readonly DependencyProperty MajorTickStartOffsetProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

MaximumLabelsProperty

Declaration

public static readonly DependencyProperty MaximumLabelsProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

MinorTickEndOffsetProperty

Declaration

public static readonly DependencyProperty MinorTickEndOffsetProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

MinorTickOffsetProperty

Declaration

public static readonly DependencyProperty MinorTickOffsetProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

MinorTicksPerIntervalProperty

Declaration

public static readonly DependencyProperty MinorTicksPerIntervalProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

MinorTickStartOffsetProperty

Declaration

public static readonly DependencyProperty MinorTickStartOffsetProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

NoOfFractionalDigitProperty

Declaration

public static readonly DependencyProperty NoOfFractionalDigitProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

NumericScaleTypeProperty

Declaration

public static readonly DependencyProperty NumericScaleTypeProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

PointersProperty

Declaration

public static readonly DependencyProperty PointersProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

RadiusFactorProperty

Declaration

public static readonly DependencyProperty RadiusFactorProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

RadiusProperty

Declaration

public static readonly DependencyProperty RadiusProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

RangeInnerEndOffsetProperty

Declaration

public static readonly DependencyProperty RangeInnerEndOffsetProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

RangeInnerStartOffsetProperty

Declaration

public static readonly DependencyProperty RangeInnerStartOffsetProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

RangeOffsetProperty

Declaration

public static readonly DependencyProperty RangeOffsetProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

RangeOuterEndOffsetProperty

Declaration

public static readonly DependencyProperty RangeOuterEndOffsetProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

RangeOuterStartOffsetProperty

Declaration

public static readonly DependencyProperty RangeOuterStartOffsetProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

RangePointerEndOffsetProperty

Declaration

public static readonly DependencyProperty RangePointerEndOffsetProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

RangePointerOffsetProperty

Declaration

public static readonly DependencyProperty RangePointerOffsetProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

RangePointerPositionProperty

Declaration

public static readonly DependencyProperty RangePointerPositionProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

RangePointerStartOffsetProperty

Declaration

public static readonly DependencyProperty RangePointerStartOffsetProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

RangePositionProperty

Declaration

public static readonly DependencyProperty RangePositionProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

RangesProperty

Declaration

public static readonly DependencyProperty RangesProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

RimStrokeProperty

Declaration

public static readonly DependencyProperty RimStrokeProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

RimStrokeThicknessProperty

Declaration

public static readonly DependencyProperty RimStrokeThicknessProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

ScaleEndOffsetProperty

Declaration

public static readonly DependencyProperty ScaleEndOffsetProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

ScaleSegProperty

Declaration

public static readonly DependencyProperty ScaleSegProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

ScaleStartOffsetProperty

Declaration

public static readonly DependencyProperty ScaleStartOffsetProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

ShowFirstLabelProperty

Declaration

public static readonly DependencyProperty ShowFirstLabelProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

ShowLabelsProperty

Declaration

public static readonly DependencyProperty ShowLabelsProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

ShowLastLabelProperty

Declaration

public static readonly DependencyProperty ShowLastLabelProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

ShowRimProperty

Declaration

public static readonly DependencyProperty ShowRimProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

ShowTicksProperty

Declaration

public static readonly DependencyProperty ShowTicksProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

SmallTickLengthProperty

Declaration

public static readonly DependencyProperty SmallTickLengthProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

SmallTickStrokeProperty

Declaration

public static readonly DependencyProperty SmallTickStrokeProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

SmallTickStrokeThicknessProperty

Declaration

public static readonly DependencyProperty SmallTickStrokeThicknessProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

StartAngleProperty

Declaration

public static readonly DependencyProperty StartAngleProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

StartPointProperty

Declaration

public static readonly DependencyProperty StartPointProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

StartValueProperty

Declaration

public static readonly DependencyProperty StartValueProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

SweepAngleProperty

Declaration

public static readonly DependencyProperty SweepAngleProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

SweepDirectionProperty

Declaration

public static readonly DependencyProperty SweepDirectionProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

SymbolPointerOffsetProperty

Declaration

public static readonly DependencyProperty SymbolPointerOffsetProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

TickLengthProperty

Declaration

public static readonly DependencyProperty TickLengthProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

TickPositionProperty

Declaration

public static readonly DependencyProperty TickPositionProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

TickShapeProperty

Declaration

public static readonly DependencyProperty TickShapeProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

TickStrokeProperty

Declaration

public static readonly DependencyProperty TickStrokeProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

TickStrokeThicknessProperty

Declaration

public static readonly DependencyProperty TickStrokeThicknessProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

ValueDiffProperty

Declaration

public static readonly DependencyProperty ValueDiffProperty

Field Value

Type	Description
Windows.UI.Xaml.DependencyProperty

Properties

BindRangeStrokeToLabels

Gets or sets a value indicating whether the Range Stroke applied to Labels Stroke

Declaration

public bool BindRangeStrokeToLabels { get; set; }

Property Value

Type	Description
System.Boolean	true if ; otherwise, false.

Remarks

The Scale should have atleast one range to make the property effective.

Value asTrue: Range Stroke is applied to the labels which are in the appropriate range.

Value asFalse: Default or user defined Stroke is applied to the labels.

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.BindRangeStrokeToLabels = true;
            scale.BindRangeStrokeToTicks = true;
            CircularRange range1 = new CircularRange();
            range1.StartValue = 0;
            range1.EndValue = 40;
            range1.Stroke = new SolidColorBrush(Colors.Green);
            range1.StrokeThickness = 10;
            CircularRange range2 = new CircularRange();
            range2.StartValue = 40;
            range2.EndValue = 60;
            range2.Stroke = new SolidColorBrush(Colors.Yellow);
            range2.StrokeThickness = 10;
            CircularRange range3 = new CircularRange();
            range3.StartValue = 60;
            range3.EndValue = 100;
            range3.Stroke = new SolidColorBrush(Colors.Red);
            range3.StrokeThickness = 10;
            scale.Ranges.Add(range1);
            scale.Ranges.Add(range2);
            scale.Ranges.Add(range3);
            gauge.MainScale = scale;

        }
    }
}

BindRangeStrokeToTicks

Gets or sets a value indicating whether the Range Stroke applied to Ticks Stroke

Declaration

public bool BindRangeStrokeToTicks { get; set; }

Property Value

Type	Description
System.Boolean	true if ; otherwise, false.

Remarks

The Scale should have atleast one range to make the property effective.

Value asTrue: Range Stroke is applied to the Ticks which are in the appropriate range.

Value asFalse: Default or user defined Stroke is applied to the Ticks.

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.BindRangeStrokeToLabels = true;
            scale.BindRangeStrokeToTicks = true;
            CircularRange range1 = new CircularRange();
            range1.StartValue = 0;
            range1.EndValue = 40;
            range1.Stroke = new SolidColorBrush(Colors.Green);
            range1.StrokeThickness = 10;
            CircularRange range2 = new CircularRange();
            range2.StartValue = 40;
            range2.EndValue = 60;
            range2.Stroke = new SolidColorBrush(Colors.Yellow);
            range2.StrokeThickness = 10;
            CircularRange range3 = new CircularRange();
            range3.StartValue = 60;
            range3.EndValue = 100;
            range3.Stroke = new SolidColorBrush(Colors.Red);
            range3.StrokeThickness = 10;
            scale.Ranges.Add(range1);
            scale.Ranges.Add(range2);
            scale.Ranges.Add(range3);
            gauge.MainScale = scale;

        }
    }
}

CustomLabels

Gets or sets the custom labels for circular scale.

Declaration

public double[] CustomLabels { get; set; }

Property Value

Type	Description
System.Double[]

EnableAutoAngle

Gets or sets the value indicating wheather the label should be rotated based on the angle or not.

Declaration

public bool EnableAutoAngle { get; set; }

Property Value

Type	Description
System.Boolean	bool

Examples

CircularScale scale = new CircularScale();
scale.EnableAutoAngle = true;

EnableAutoInterval

Declaration

public bool EnableAutoInterval { get; set; }

Property Value

Type	Description
System.Boolean

EnableSmartLabels

Gets or sets a value indicating whether to display smart labels or not .

Declaration

public bool EnableSmartLabels { get; set; }

Property Value

Type	Description
System.Boolean	true if ; otherwise, false.

Remarks

This property helps to set the Numeric scale type to the labels displayed in scale

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.EnableSmartLabels = true;
            scale.NoOfFractionalDigit = 1;
            gauge.MainScale = scale;
        }
    }
}

EndPoint

Gets EndPoint of the CircularScale.

Declaration

public Point EndPoint { get; }

Property Value

Type	Description
Windows.Foundation.Point	Point

Remarks

EndPoint is a read only property used to get the value of the EndPoint.

EndValue

Gets or sets the EndValue of the CircularScale that decides the overall range of the scale.

Declaration

public double EndValue { get; set; }

Property Value

Type	Description
System.Double	double

Remarks

StartValue and EndValue properties will decides the overall range of the Circular Rim

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.StartAngle = 180;
            scale.SweepAngle = 180;
            scale.SweepDirection = SweepDirection.Clockwise;
            scale.StartValue = 0;
            scale.EndValue = 100;
            scale.RimStroke = new SolidColorBrush(Colors.Black);
            scale.RimStrokeThickness =3;
            gauge.MainScale = scale;
        }
    }
}

Interval

Gets or sets the Interval value of the CircularScale that used to calculate the Tick count.

Declaration

public double Interval { get; set; }

Property Value

Type	Description
System.Double	double

Remarks

Interval property is used to calculate the Tick count for a scale based on StartValue and EndValue.

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.Interval = 20;
            gauge.MainScale = scale;
        }
    }
}

IsLogarithmic

Gets or sets a value indicating whether the label values should be logarithm

Declaration

public bool IsLogarithmic { get; set; }

Property Value

Type	Description
System.Boolean	bool

IsLogLabelSuperscriptEnabled

Gets or sets a value indicating whether the label values should be super script enabled

Declaration

public bool IsLogLabelSuperscriptEnabled { get; set; }

Property Value

Type	Description
System.Boolean	bool

LabelAutoSizeChange

Gets or sets the Boolean property that allow user to decided whether the gauge label can resize automatically.

Declaration

public bool LabelAutoSizeChange { get; set; }

Property Value

Type	Description
System.Boolean	bool

Remarks

LabelAutoSizeChange property will remains effective until the user set it to false.

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.LabelAutoSizeChange = true;
            gauge.MainScale = scale;
        }
    }
}

LabelOffset

Gets or sets LabelOffset that decides the offset of Labels in the CircularScale.

Declaration

public double LabelOffset { get; set; }

Property Value

Type	Description
System.Double	double

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.LabelOffset = 10;
            gauge.Scales.add(scale);
        }
    }
}

LabelPosition

Gets or sets LabelPosition that decides the position of Labels in the CircularScale.

Declaration

public LabelPosition LabelPosition { get; set; }

Property Value

Type	Description
LabelPosition	LabelPosition

Remarks

The Labels in the scale can be placed inside the scale or outside the scale by choosing the options avail in the LabelPosition property. Options are 1. Inside (Default) : Places the Labels inside the scale. 2. Outside : Places the Labels outside the scale.

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.LabelPosition = LabelPosition.Outside;
            gauge.MainScale = scale;
        }
    }
}

LabelPostfix

Gets or sets the LabelPostfix value that can attached at the end of the labels.

Declaration

public string LabelPostfix { get; set; }

Property Value

Type	Description
System.String	string

Remarks

Used to add some extentions to the labels like % symbol can be added to labels while displaying the percentage values in SfCircularGauge.

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.LabelPostfix="%";
            gauge.MainScale = scale;
        }
    }
}

LabelPrefix

Gets or sets the LabelPrefix value that can be added before the labels.

Declaration

public string LabelPrefix { get; set; }

Property Value

Type	Description
System.String	string

Remarks

Used to add some prefix to the labels like $ symbol can be added to labels while displaying the dollar values in SfCircularGauge.

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.LabelPrefix="$";
            gauge.MainScale = scale;
        }
    }
}

LabelStroke

Gets or sets the brush that describes the Stroke value of the Labels.

Declaration

public Brush LabelStroke { get; set; }

Property Value

Type	Description
Windows.UI.Xaml.Media.Brush	Brush

Remarks

LabelStroke property will remains effective until the value of the BindRangeStrokeToLabels property is false.

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.LabelStroke = new SolidColorBrush(Colors.Red);
            gauge.MainScale = scale;
        }
    }
}

LogBase

Gets or sets the base of the log.

Declaration

public int LogBase { get; set; }

Property Value

Type	Description
System.Int32	int

LogExponentInterval

Gets or sets the exponential interval of the log.

Declaration

public int LogExponentInterval { get; set; }

Property Value

Type	Description
System.Int32	int

MajorTickEndOffset

Declaration

public double MajorTickEndOffset { get; set; }

Property Value

Type	Description
System.Double

MajorTickOffset

Gets or sets MajorTickOffset that decides the offset of major ticks in the CircularScale.

Declaration

public double MajorTickOffset { get; set; }

Property Value

Type	Description
System.Double	double

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.MajorTickOffset = 10;
            gauge.Scales.add(scale);
        }
    }
}

MajorTickStartOffset

Declaration

public double MajorTickStartOffset { get; set; }

Property Value

Type	Description
System.Double

MaximumLabels

Declaration

public int MaximumLabels { get; set; }

Property Value

Type	Description
System.Int32

MinorTickEndOffset

Declaration

public double MinorTickEndOffset { get; set; }

Property Value

Type	Description
System.Double

MinorTickOffset

Gets or sets MinorTickOffset that decides the offset of minor ticks in the CircularScale.

Declaration

public double MinorTickOffset { get; set; }

Property Value

Type	Description
System.Double	double

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.MinorTickOffset = 10;
            gauge.Scales.add(scale);
        }
    }
}

MinorTicksPerInterval

Gets or sets the value that used to calculate the MinorTicks count in the scale.

Declaration

public int MinorTicksPerInterval { get; set; }

Property Value

Type	Description
System.Int32	double

Remarks

MinorTicksPerInterval property is used to calculate the MinorTicks count for a scale based on StartValue and EndValue.

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.MinorTicksPerInterval = 2;
            gauge.MainScale = scale;
        }
    }
}

MinorTickStartOffset

Declaration

public double MinorTickStartOffset { get; set; }

Property Value

Type	Description
System.Double

NoOfFractionalDigit

Gets or sets the number of fractional digit has to be displayed in the Scale labels..

Declaration

public int NoOfFractionalDigit { get; set; }

Property Value

Type	Description
System.Int32	int

Remarks

Default value of this property is 1. If the values have large no of fractional values then the fractional value count is reduced to one.

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.EnableSmartLabels = true;
            scale.NoOfFractionalDigit = 1;
            gauge.MainScale = scale;
        }
    }
}

NumericScaleType

Gets or sets the numeric scale type of the scale.

Declaration

public NumericScaleType NumericScaleType { get; set; }

Property Value

Type	Description
NumericScaleType	NumericScaleType

Remarks

Default value of this property is Auto. This property remains active only when EnableSmartLabels property is set to true.

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.EnableSmartLabels = true;
            scale.NoOfFractionalDigit = 1;
            gauge.MainScale = scale;
        }
    }
}

Pointers

Gets or sets collection of Pointers to the CircularScale.

Declaration

public CircularPointerCollection Pointers { get; set; }

Property Value

Type	Description
CircularPointerCollection	CircularPointerCollection

Remarks

User can add multiple pointers to the gauge to point at multiple values on the same scale. This can be useful for showing a low and a high value at the same time. Value of the pointer is set by the Value property.

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
           InitializeComponent();
           SfCircularGauge gauge = new SfCircularGauge();
           CircularPointer needlePointer = new CircularPointer();
           needlePointer.Value = 80;
           needlePointer.PointerType = PointerType.NeedlePointer;
           needlePointer.EnableAnimation = true;
           needlePointer.NeedleLengthFactor = 0.5;
           needlePointer.NeedlePointerStroke = new SolidColorBrush(Colors.White);
           needlePointer.NeedlePointerStrokeThickness = 2;
           needlePointer.PointerCapStroke = new SolidColorBrush(Colors.White);
           needlePointer.PointerCapDiameter = 20;
           gauge.MainScale.Pointers.Add(needlePointer);
        }
    }
}

Radius

Gets or sets the radius of the CircularScale.

Declaration

public double Radius { get; set; }

Property Value

Type	Description
System.Double	double

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
           InitializeComponent();
           SfCircularGauge gauge = new SfCircularGauge();
           CircularScale scale = new CircularScale();
           scale.Radius = 200;
           gauge.MainScale = scale;
        }
    }
}

RadiusFactor

Declaration

public double RadiusFactor { get; set; }

Property Value

Type	Description
System.Double

RangeInnerEndOffset

Declaration

public double RangeInnerEndOffset { get; set; }

Property Value

Type	Description
System.Double

RangeInnerStartOffset

Declaration

public double RangeInnerStartOffset { get; set; }

Property Value

Type	Description
System.Double

RangeOffset

Gets or sets RangeOffset that decides the offset of ranges in the CircularScale.

Declaration

public double RangeOffset { get; set; }

Property Value

Type	Description
System.Double	double

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class Gauge
    {
        public Gauge()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.RangeOffset=2;
            gauge.Scales.add(scale);
        }
    }
}

RangeOuterEndOffset

Declaration

public double RangeOuterEndOffset { get; set; }

Property Value

Type	Description
System.Double

RangeOuterStartOffset

Declaration

public double RangeOuterStartOffset { get; set; }

Property Value

Type	Description
System.Double

RangePointerEndOffset

Declaration

public double RangePointerEndOffset { get; set; }

Property Value

Type	Description
System.Double

RangePointerOffset

Gets or sets RangePointerOffset that decides the offset of RangePointer in the CircularScale.

Declaration

public double RangePointerOffset { get; set; }

Property Value

Type	Description
System.Double	double

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class Gauge
    {
        public Gauge()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.RangePointerOffset = 5;
            gauge.Scales.add(scale);
        }
    }
}

RangePointerPosition

Gets or sets RangePointerPosition that decides the position of RangePointer in the CircularScale.

Declaration

public RangePointerPosition RangePointerPosition { get; set; }

Property Value

Type	Description
RangePointerPosition	RangePointerPosition

Remarks

The RangePointer in the scale can be placed inside the scale or outside the scale by choosing the options avail in the RangePointerPosition property. Options are 1. Inside (Default) : Places the RangePointer inside the scale. 2. Outside : Places the RangePointer outside the scale.

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.RangePointerPosition = RangePointerPosition.Outside;
            gauge.MainScale = scale;
        }
    }
}

RangePointerStartOffset

Declaration

public double RangePointerStartOffset { get; set; }

Property Value

Type	Description
System.Double

RangePosition

Gets or sets RangePosition that decides the position of ranges in the CircularScale.

Declaration

public RangePosition RangePosition { get; set; }

Property Value

Type	Description
RangePosition	RangePosition

Remarks

The Ranges in the scale can be placed inside the scale or outside the scale by choosing the options avail in the RangePosition property. Options are 1. Inside (Default) : Places the Ranges inside the scale. 2. Outside : Places the Ranges outside the scale. 3. SetAsScaleRim : Placed the Ranges on the Scale Rim.

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.RangePosition = RangePosition.Outside;
            gauge.MainScale = scale;
        }
    }
}

Ranges

Gets or sets the collection of Ranges to the CircularScale.

Declaration

public CircularRangeCollection Ranges { get; set; }

Property Value

Type	Description
CircularRangeCollection	CircularRangeCollection

Remarks

A range is a visual element which begins and ends at specified values within a scale. These start and end values are set by the StartValue and EndValue properties of Range. Range’s UI is customized by the Stroke and StrokeThickness Properties.

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
           InitializeComponent();
           SfCircularGauge gauge = new SfCircularGauge();
           CircularRange range1 = new CircularRange();
           range1.StartValue = 0;
           range1.EndValue = 40;
           range1.Stroke = new SolidColorBrush(Colors.Green);
           range1.StrokeThickness = 10;
           CircularRange range2 = new CircularRange();
           range2.StartValue = 40;
           range2.EndValue = 60;
           range2.Stroke = new SolidColorBrush(Colors.Yellow);
           range2.StrokeThickness = 10;
           CircularRange range3 = new CircularRange();
           range3.StartValue = 60;
           range3.EndValue = 100;
           range3.Stroke = new SolidColorBrush(Colors.Red);
           range3.StrokeThickness = 10;
           gauge.MainScale.Ranges.Add(range1);
           gauge.MainScale.Ranges.Add(range2);
           gauge.MainScale.Ranges.Add(range3);
        }
    }
}

RimStroke

Gets or sets the brush that describes the RimStroke value of the CircularScale.

Declaration

public Brush RimStroke { get; set; }

Property Value

Type	Description
Windows.UI.Xaml.Media.Brush	Brush

Remarks

RimStroke property will remains effective until the value of the RangePostion property is not set to 'SetAsScaleRim'.

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.RimStroke = new SolidColorBrush(Colors.Red);
            gauge.MainScale = scale;
        }
    }
}

RimStrokeThickness

Gets or sets the thickness of the RimStroke.

Declaration

public double RimStrokeThickness { get; set; }

Property Value

Type	Description
System.Double	double

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
           InitializeComponent();
           SfCircularGauge gauge = new SfCircularGauge();
           CircularScale scale = new CircularScale();
           scale.RimStrokeThickness =3;
           gauge.MainScale = scale;
        }
    }
}

ScaleEndOffset

Declaration

public double ScaleEndOffset { get; set; }

Property Value

Type	Description
System.Double

ScaleSeg

Declaration

public PathSegmentCollection ScaleSeg { get; set; }

Property Value

Type	Description
Windows.UI.Xaml.Media.PathSegmentCollection

ScaleStartOffset

Declaration

public double ScaleStartOffset { get; set; }

Property Value

Type	Description
System.Double

ShowFirstLabel

Declaration

public bool ShowFirstLabel { get; set; }

Property Value

Type	Description
System.Boolean

ShowLabels

Gets or sets the ShowLabels

Declaration

public bool ShowLabels { get; set; }

Property Value

Type	Description
System.Boolean

ShowLastLabel

Declaration

public bool ShowLastLabel { get; set; }

Property Value

Type	Description
System.Boolean

ShowRim

Gets or sets the ShowRim

Declaration

public bool ShowRim { get; set; }

Property Value

Type	Description
System.Boolean

ShowTicks

Gets or sets the ShowTicks

Declaration

public bool ShowTicks { get; set; }

Property Value

Type	Description
System.Boolean

SmallTickLength

Gets or sets value that decides the length of the small ticks in the CircularScale.

Declaration

public double SmallTickLength { get; set; }

Property Value

Type	Description
System.Double	double

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
           InitializeComponent();
           SfCircularGauge gauge = new SfCircularGauge();
           CircularScale scale = new CircularScale();
           scale.SmallTickLength = 10;
           gauge.MainScale = scale;
        }
    }
}

SmallTickStroke

Gets or sets the brush that describes the SmallTickStroke of the CircularScale.

Declaration

public Brush SmallTickStroke { get; set; }

Property Value

Type	Description
Windows.UI.Xaml.Media.Brush	Brush

Remarks

SmallTickStroke property will remains effective until the value of the BindRangeStrokeToTicks property is false.

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.SmallTickStroke = new SolidColorBrush(Colors.Red);
            gauge.MainScale = scale;
        }
    }
}

SmallTickStrokeThickness

Gets or sets the thickness of the SmallTickStroke.

Declaration

public double SmallTickStrokeThickness { get; set; }

Property Value

Type	Description
System.Double	double

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
           InitializeComponent();
           SfCircularGauge gauge = new SfCircularGauge();
           CircularScale scale = new CircularScale();
           scale.SmallTickStrokeThickness =3;
           gauge.MainScale = scale;
        }
    }
}

StartAngle

Gets or sets the StartAngle of the CircularScale that decides the shape of the SfCircularGauge.

Declaration

public double StartAngle { get; set; }

Property Value

Type	Description
System.Double	double

Remarks

By setting the StartAngle, SweepDirection and SweepAngle we can shape the Circular Gauge into Full Circular Gauge, Half Circular Gauge, and Quarter Circular Gauge.

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.StartAngle = 180;
            scale.SweepAngle = 180;
            scale.SweepDirection = SweepDirection.Clockwise;
            scale.StartValue = 0;
            scale.EndValue = 100;
            gauge.MainScale = scale;
        }
    }
}

StartPoint

Gets or sets StartPoint of the CircularScale.

Declaration

public Point StartPoint { get; }

Property Value

Type	Description
Windows.Foundation.Point	Point

Remarks

StartPoint is a read only property used to get the value of the StartPoint.

StartValue

Gets or sets the StartValue of the CircularScale that decides the overall range of the scale.

Declaration

public double StartValue { get; set; }

Property Value

Type	Description
System.Double	double

Remarks

StartValue and EndValue properties will decides the overall range of the Circular Rim

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.StartAngle = 180;
            scale.SweepAngle = 180;
            scale.SweepDirection = SweepDirection.Clockwise;
            scale.StartValue = 0;
            scale.EndValue = 100;
            scale.RimStroke = new SolidColorBrush(Colors.Black);
            scale.RimStrokeThickness =3;
            gauge.MainScale = scale;
        }
    }
}

SweepAngle

Gets or sets the SweepAngle of the CircularScale that decides the shape of the SfCircularGauge

Declaration

public double SweepAngle { get; set; }

Property Value

Type	Description
System.Double	double

Remarks

By setting the StartAngle, SweepDirection and SweepAngle we can shape the Circular Gauge into Full Circular Gauge, Half Circular Gauge, and Quarter Circular Gauge.

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.StartAngle = 180;
            scale.SweepAngle = 180;
            scale.SweepDirection = SweepDirection.Clockwise;
            scale.StartValue = 0;
            scale.EndValue = 100;
            gauge.MainScale = scale;
        }
    }
}

SweepDirection

Gets or sets SweepDirection that decides the rendering direction of the elements in CircularScale.

Declaration

public SweepDirection SweepDirection { get; set; }

Property Value

Type	Description
Windows.UI.Xaml.Media.SweepDirection	SweepDirection

Remarks

SweepDirection property decides in which direction labels and ticks have to be rendered in the CircularScale.

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.StartAngle = 180;
            scale.SweepAngle = 180;
            scale.SweepDirection = SweepDirection.Clockwise;
            scale.StartValue = 0;
            scale.EndValue = 100;
            gauge.MainScale = scale;
        }
    }
}

SymbolPointerOffset

Declaration

public double SymbolPointerOffset { get; set; }

Property Value

Type	Description
System.Double

TickLength

Gets or sets value that decides the length of the ticks in the CircularScale.

Declaration

public double TickLength { get; set; }

Property Value

Type	Description
System.Double	double

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
           InitializeComponent();
           SfCircularGauge gauge = new SfCircularGauge();
           CircularScale scale = new CircularScale();
           scale.TickLength = 10;
           gauge.MainScale = scale;
        }
    }
}

TickPosition

Gets or sets TickPosition that decides the position of ticks in the CircularScale.

Declaration

public TickPosition TickPosition { get; set; }

Property Value

Type	Description
TickPosition	TickPosition

Remarks

The Ticks in the scale can be placed inside the scale, outside or on top of the scale by choosing the options avail in the TickPosition property. Options are 1. Inside (Default) : Places the Ticks inside the scale. 2. Outside : Places the Ticks outside the scale. 3. Cross : Places the Ticks on top of the scale.

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.TickPosition = TickPosition.Outside;
            gauge.MainScale = scale;
        }
    }
}

TickShape

Gets or sets the shape of the circular scale's tick.

Declaration

public TickShape TickShape { get; set; }

Property Value

Type	Description
TickShape	TickShape

Remarks

The shape of the Scales Major and Minor ticks can be set by using TickShape property and it’s includes following option. Ellipse , Rectangle ,Triangle The default value of TickShape property is TickShape.Rectangle.

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.TickShape = TickShape.Rectangle;
            gauge.MainScale = scale;
        }
    }
}

TickStroke

Gets or sets the brush that describes the TickStroke of the CircularScale.

Declaration

public Brush TickStroke { get; set; }

Property Value

Type	Description
Windows.UI.Xaml.Media.Brush	Brush

Remarks

TickStroke property will remains effective until the value of the BindRangeStrokeToTicks property is false.

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
            InitializeComponent();
            SfCircularGauge gauge = new SfCircularGauge();
            CircularScale scale = new CircularScale();
            scale.TickStroke = new SolidColorBrush(Colors.Red);
            gauge.MainScale = scale;
        }
    }
}

TickStrokeThickness

Gets or sets the thickness of the TickStroke.

Declaration

public double TickStrokeThickness { get; set; }

Property Value

Type	Description
System.Double	double

Examples

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Controls.Primitives;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Media;
using Windows.UI.Xaml.Navigation;
using Common;
using Syncfusion.UI.Xaml.Gauges;

namespace GaugeWinRTSamples
{
    public sealed partial class GaugePosition :SampleView
    {
        public GaugePosition()
        {
           InitializeComponent();
           SfCircularGauge gauge = new SfCircularGauge();
           CircularScale scale = new CircularScale();
           scale.TickStrokeThickness =3;
           gauge.MainScale = scale;
        }
    }
}

Methods

Dispose()

Method to release allocated resources of CircularScale.

Declaration

public void Dispose()

MeasureOverride(Size)

Declaration

protected override Size MeasureOverride(Size availableSize)

Parameters

Type	Name	Description
Windows.Foundation.Size	availableSize

Returns

Type	Description
Windows.Foundation.Size

OnApplyTemplate()

Declaration

protected override void OnApplyTemplate()

Events

LabelCreated

Declaration

public event EventHandler<LabelCreatedEventArgs> LabelCreated

Event Type

Type	Description
System.EventHandler<LabelCreatedEventArgs>

Implements

System.IDisposable

Extension Methods

DateTimeExtension.ToDateTime(Object)

UWP- v19.1.0.54

Class CircularScale

Inheritance

Implements

Namespace: Syncfusion.UI.Xaml.Gauges

Assembly: Syncfusion.SfGauge.UWP.dll

Syntax

Constructors

CircularScale()

Declaration

Remarks

Fields

BindRangeStrokeToLabelsProperty

Declaration

Field Value

BindRangeStrokeToTicksProperty

Declaration

Field Value

CustomLabelsProperty

Declaration

Field Value

EnableAutoAngleProperty

Declaration

Field Value

EnableAutoIntervalProperty

Declaration

Field Value

EnableSmartLabelsProperty

Declaration

Field Value

EndPointProperty

Declaration

Field Value

EndValueProperty

Declaration

Field Value

IntervalProperty

Declaration

Field Value

IsLogarithmicProperty

Declaration

Field Value

IsLogLabelSuperscriptEnabledProperty

Declaration

Field Value

LabelAutoSizeChangeProperty

Declaration

Field Value

LabelOffsetProperty

Declaration

Field Value

LabelPositionProperty

Declaration

Field Value

LabelPostfixProperty

Declaration

Field Value

LabelPrefixProperty

Declaration

Field Value

LabelStrokeProperty

Declaration

Field Value

LogBaseProperty

Declaration

Field Value

LogExponentIntervalProperty

Declaration

Field Value

MajorTickEndOffsetProperty

Declaration

Field Value

MajorTickOffsetProperty

Declaration

Field Value

MajorTickStartOffsetProperty

Declaration

Field Value

MaximumLabelsProperty

Declaration