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.WPF.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
System.Windows.DependencyProperty

BindRangeStrokeToTicksProperty

Declaration

public static readonly DependencyProperty BindRangeStrokeToTicksProperty

Field Value

Type	Description
System.Windows.DependencyProperty

CanRotateLabelsProperty

Declaration

public static readonly DependencyProperty CanRotateLabelsProperty

Field Value

Type	Description
System.Windows.DependencyProperty

EnableSmartLabelsProperty

Declaration

public static readonly DependencyProperty EnableSmartLabelsProperty

Field Value

Type	Description
System.Windows.DependencyProperty

EndPointProperty

Declaration

public static readonly DependencyProperty EndPointProperty

Field Value

Type	Description
System.Windows.DependencyProperty

EndValueProperty

Declaration

public static readonly DependencyProperty EndValueProperty

Field Value

Type	Description
System.Windows.DependencyProperty

IntervalProperty

Declaration

public static readonly DependencyProperty IntervalProperty

Field Value

Type	Description
System.Windows.DependencyProperty

IsLogarithmicProperty

Declaration

public static readonly DependencyProperty IsLogarithmicProperty

Field Value

Type	Description
System.Windows.DependencyProperty

IsLogLabelSuperscriptEnabledProperty

Declaration

public static readonly DependencyProperty IsLogLabelSuperscriptEnabledProperty

Field Value

Type	Description
System.Windows.DependencyProperty

LabelAutoSizeChangeProperty

Declaration

public static readonly DependencyProperty LabelAutoSizeChangeProperty

Field Value

Type	Description
System.Windows.DependencyProperty

LabelOffsetProperty

Declaration

public static readonly DependencyProperty LabelOffsetProperty

Field Value

Type	Description
System.Windows.DependencyProperty

LabelPositionProperty

Declaration

public static readonly DependencyProperty LabelPositionProperty

Field Value

Type	Description
System.Windows.DependencyProperty

LabelPostfixProperty

Declaration

public static readonly DependencyProperty LabelPostfixProperty

Field Value

Type	Description
System.Windows.DependencyProperty

LabelPrefixProperty

Declaration

public static readonly DependencyProperty LabelPrefixProperty

Field Value

Type	Description
System.Windows.DependencyProperty

LabelStrokeProperty

Declaration

public static readonly DependencyProperty LabelStrokeProperty

Field Value

Type	Description
System.Windows.DependencyProperty

LogBaseProperty

Declaration

public static readonly DependencyProperty LogBaseProperty

Field Value

Type	Description
System.Windows.DependencyProperty

LogExponentIntervalProperty

Declaration

public static readonly DependencyProperty LogExponentIntervalProperty

Field Value

Type	Description
System.Windows.DependencyProperty

MajorTickOffsetProperty

Declaration

public static readonly DependencyProperty MajorTickOffsetProperty

Field Value

Type	Description
System.Windows.DependencyProperty

MajorTickSettingsProperty

Declaration

public static readonly DependencyProperty MajorTickSettingsProperty

Field Value

Type	Description
System.Windows.DependencyProperty

MinorTickOffsetProperty

Declaration

public static readonly DependencyProperty MinorTickOffsetProperty

Field Value

Type	Description
System.Windows.DependencyProperty

MinorTickSettingsProperty

Declaration

public static readonly DependencyProperty MinorTickSettingsProperty

Field Value

Type	Description
System.Windows.DependencyProperty

MinorTicksPerIntervalProperty

Declaration

public static readonly DependencyProperty MinorTicksPerIntervalProperty

Field Value

Type	Description
System.Windows.DependencyProperty

NoOfFractionalDigitProperty

Declaration

public static readonly DependencyProperty NoOfFractionalDigitProperty

Field Value

Type	Description
System.Windows.DependencyProperty

NumericScaleTypeProperty

Declaration

public static readonly DependencyProperty NumericScaleTypeProperty

Field Value

Type	Description
System.Windows.DependencyProperty

PointersProperty

Declaration

public static readonly DependencyProperty PointersProperty

Field Value

Type	Description
System.Windows.DependencyProperty

RadiusFactorProperty

Declaration

public static readonly DependencyProperty RadiusFactorProperty

Field Value

Type	Description
System.Windows.DependencyProperty

RadiusProperty

Declaration

public static readonly DependencyProperty RadiusProperty

Field Value

Type	Description
System.Windows.DependencyProperty

RangeOffsetProperty

Declaration

public static readonly DependencyProperty RangeOffsetProperty

Field Value

Type	Description
System.Windows.DependencyProperty

RangePointerOffsetProperty

Declaration

public static readonly DependencyProperty RangePointerOffsetProperty

Field Value

Type	Description
System.Windows.DependencyProperty

RangePointerPositionProperty

Declaration

public static readonly DependencyProperty RangePointerPositionProperty

Field Value

Type	Description
System.Windows.DependencyProperty

RangePositionProperty

Declaration

public static readonly DependencyProperty RangePositionProperty

Field Value

Type	Description
System.Windows.DependencyProperty

RangesProperty

Declaration

public static readonly DependencyProperty RangesProperty

Field Value

Type	Description
System.Windows.DependencyProperty

RimEndOffsetProperty

Declaration

public static readonly DependencyProperty RimEndOffsetProperty

Field Value

Type	Description
System.Windows.DependencyProperty

RimStartOffsetProperty

Declaration

public static readonly DependencyProperty RimStartOffsetProperty

Field Value

Type	Description
System.Windows.DependencyProperty

RimStrokeProperty

Declaration

public static readonly DependencyProperty RimStrokeProperty

Field Value

Type	Description
System.Windows.DependencyProperty

RimStrokeThicknessProperty

Declaration

public static readonly DependencyProperty RimStrokeThicknessProperty

Field Value

Type	Description
System.Windows.DependencyProperty

ScaleSegProperty

Declaration

public static readonly DependencyProperty ScaleSegProperty

Field Value

Type	Description
System.Windows.DependencyProperty

ShowFirstLabelProperty

Declaration

public static readonly DependencyProperty ShowFirstLabelProperty

Field Value

Type	Description
System.Windows.DependencyProperty

ShowLabelsProperty

Declaration

public static readonly DependencyProperty ShowLabelsProperty

Field Value

Type	Description
System.Windows.DependencyProperty

ShowLastLabelProperty

Declaration

public static readonly DependencyProperty ShowLastLabelProperty

Field Value

Type	Description
System.Windows.DependencyProperty

ShowRimProperty

Declaration

public static readonly DependencyProperty ShowRimProperty

Field Value

Type	Description
System.Windows.DependencyProperty

ShowTicksProperty

Declaration

public static readonly DependencyProperty ShowTicksProperty

Field Value

Type	Description
System.Windows.DependencyProperty

SmallTickLengthProperty

Declaration

public static readonly DependencyProperty SmallTickLengthProperty

Field Value

Type	Description
System.Windows.DependencyProperty

SmallTickStrokeProperty

Declaration

public static readonly DependencyProperty SmallTickStrokeProperty

Field Value

Type	Description
System.Windows.DependencyProperty

SmallTickStrokeThicknessProperty

Declaration

public static readonly DependencyProperty SmallTickStrokeThicknessProperty

Field Value

Type	Description
System.Windows.DependencyProperty

StartAngleProperty

Declaration

public static readonly DependencyProperty StartAngleProperty

Field Value

Type	Description
System.Windows.DependencyProperty

StartPointProperty

Declaration

public static readonly DependencyProperty StartPointProperty

Field Value

Type	Description
System.Windows.DependencyProperty

StartValueProperty

Declaration

public static readonly DependencyProperty StartValueProperty

Field Value

Type	Description
System.Windows.DependencyProperty

SweepAngleProperty

Declaration

public static readonly DependencyProperty SweepAngleProperty

Field Value

Type	Description
System.Windows.DependencyProperty

SweepDirectionProperty

Declaration

public static readonly DependencyProperty SweepDirectionProperty

Field Value

Type	Description
System.Windows.DependencyProperty

TickLengthProperty

Declaration

public static readonly DependencyProperty TickLengthProperty

Field Value

Type	Description
System.Windows.DependencyProperty

TickPositionProperty

Declaration

public static readonly DependencyProperty TickPositionProperty

Field Value

Type	Description
System.Windows.DependencyProperty

TickShapeProperty

Declaration

public static readonly DependencyProperty TickShapeProperty

Field Value

Type	Description
System.Windows.DependencyProperty

TickStrokeProperty

Declaration

public static readonly DependencyProperty TickStrokeProperty

Field Value

Type	Description
System.Windows.DependencyProperty

TickStrokeThicknessProperty

Declaration

public static readonly DependencyProperty TickStrokeThicknessProperty

Field Value

Type	Description
System.Windows.DependencyProperty

ValueDiffProperty

Declaration

public static readonly DependencyProperty ValueDiffProperty

Field Value

Type	Description
System.Windows.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;

        }
    }
}

CanRotateLabels

Gets or sets a boolean that denotes whether rotate the labels based on angle.

Declaration

public bool CanRotateLabels { 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
System.Windows.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
System.Windows.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

MajorTickOffset

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

Declaration

[Obsolete("MajorTickOffset property will soon be deprecated. Use Offset property of MajorTickSetting instead")]
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);
        }
    }
}

MajorTickSettings

Gets or sets the settings to customize the major ticks properties of circular scale.

Declaration

public MajorTickSetting MajorTickSettings { get; set; }

Property Value

Type	Description
MajorTickSetting

MinorTickOffset

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

Declaration

[Obsolete("MinorTickOffset property will soon be deprecated. Use Offset property of MinorTickSetting instead")]
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);
        }
    }
}

MinorTickSettings

Gets or sets the settings to customize the major ticks properties of circular scale.

Declaration

public MinorTickSetting MinorTickSettings { get; set; }

Property Value

Type	Description
MinorTickSetting

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;
        }
    }
}

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

RangeOffset

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

Declaration

[Obsolete("RangeOffset property will soon be deprecated. Use Offset property of CircularRange instead")]
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);
        }
    }
}

RangePointerOffset

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

Declaration

[Obsolete("RangePointerOffset property will soon be deprecated. Use Offset property of CircularPointer instead")]
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;
        }
    }
}

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);
        }
    }
}

RimEndOffset

Gets or sets the rim end offset position. Its range is from 0 to 1.

Declaration

public double RimEndOffset { get; set; }

Property Value

Type	Description
System.Double

RimStartOffset

Gets or sets the rim start offset position. Its range is from 0 to 1.

Declaration

public double RimStartOffset { get; set; }

Property Value

Type	Description
System.Double

RimStroke

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

Declaration

public Brush RimStroke { get; set; }

Property Value

Type	Description
System.Windows.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;
        }
    }
}

ScaleSeg

Declaration

public PathSegmentCollection ScaleSeg { get; set; }

Property Value

Type	Description
System.Windows.Media.PathSegmentCollection

ShowFirstLabel

Gets or sets boolean to enable or disable first label.

Declaration

public bool ShowFirstLabel { get; set; }

Property Value

Type	Description
System.Boolean

ShowLabels

Gets or sets a value to enable or disable the labels.

Declaration

public bool ShowLabels { get; set; }

Property Value

Type	Description
System.Boolean

ShowLastLabel

Gets or sets boolean to enable or disable last label.

Declaration

public bool ShowLastLabel { get; set; }

Property Value

Type	Description
System.Boolean

ShowRim

Gets or sets a value to enable or disable the rim.

Declaration

public bool ShowRim { get; set; }

Property Value

Type	Description
System.Boolean

ShowTicks

Gets or sets a value to enable or disable the major and minor ticks.

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

[Obsolete("SmallTickLength property will soon be deprecated. Use Length property of MinorTickSettings instead")]
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

[Obsolete("SmallTickStroke property will soon be deprecated. Use Stroke property of MinorTickSettings instead")]
public Brush SmallTickStroke { get; set; }

Property Value

Type	Description
System.Windows.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

[Obsolete("SmallTickStrokeThickness property will soon be deprecated. Use StrokeThickness property of MinorTickSettings instead")]
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
System.Windows.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
System.Windows.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;
        }
    }
}

TickLength

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

Declaration

[Obsolete("TickLength property will soon be deprecated. Use Length property of MajorTickSettings instead")]
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

[Obsolete("TickStroke property will soon be deprecated. Use Stroke property of MajorTickSettings instead")]
public Brush TickStroke { get; set; }

Property Value

Type	Description
System.Windows.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

[Obsolete("TickStrokeThickness property will soon be deprecated. Use StrokeThickness property of MajorTickSettings instead")]
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
System.Windows.Size	availableSize

Returns

Type	Description
System.Windows.Size

OnApplyTemplate()

Declaration

public override void OnApplyTemplate()

Events

LabelCreated

Raise the event when creating label to change the content of label.

Declaration

public event EventHandler<LabelCreatedEventArgs> LabelCreated

Event Type

Type	Description
System.EventHandler<LabelCreatedEventArgs>

Implements

System.IDisposable