Class SfDigitalGauge

Represents the control which helps the user to visualize the data in digital character

Inheritance

System.Object

SfDigitalGauge

Implements

System.IDisposable

Namespace: Syncfusion.UI.Xaml.Gauges

Assembly: Syncfusion.SfGauge.WPF.dll

Syntax

public class SfDigitalGauge : Control, IDisposable

Constructors

SfDigitalGauge()

Initializes a new instance of the SfDigitalGauge class.

Declaration

public SfDigitalGauge()

Fields

CharacterHeightProperty

Identifies the CharacterHeight dependency property.

Declaration

public static readonly DependencyProperty CharacterHeightProperty

Field Value

Type
System.Windows.DependencyProperty

CharactersSpacingProperty

Identifies the CharactersSpacing dependency property.

Declaration

public static readonly DependencyProperty CharactersSpacingProperty

Field Value

Type
System.Windows.DependencyProperty

CharacterStrokeProperty

Declaration

public static readonly DependencyProperty CharacterStrokeProperty

Field Value

Type
System.Windows.DependencyProperty

CharacterTypeProperty

Declaration

public static readonly DependencyProperty CharacterTypeProperty

Field Value

Type
System.Windows.DependencyProperty

CharacterWidthProperty

Declaration

public static readonly DependencyProperty CharacterWidthProperty

Field Value

Type
System.Windows.DependencyProperty

DimmedBrushOpacityProperty

Declaration

public static readonly DependencyProperty DimmedBrushOpacityProperty

Field Value

Type
System.Windows.DependencyProperty

DimmedBrushProperty

Identifies the DimmedBrush dependency property.

Declaration

public static readonly DependencyProperty DimmedBrushProperty

Field Value

Type
System.Windows.DependencyProperty

EnableRTLFormatProperty

Declaration

public static readonly DependencyProperty EnableRTLFormatProperty

Field Value

Type
System.Windows.DependencyProperty

SegmentThicknessProperty

Identifies the SegmentThickness dependency property.

Declaration

public static readonly DependencyProperty SegmentThicknessProperty

Field Value

Type
System.Windows.DependencyProperty

SkewAngleXProperty

Identifies the SkewAngleX dependency property.

Declaration

public static readonly DependencyProperty SkewAngleXProperty

Field Value

Type
System.Windows.DependencyProperty

SkewAngleYProperty

Identifies the SkewAngleY dependency property.

Declaration

public static readonly DependencyProperty SkewAngleYProperty

Field Value

Type
System.Windows.DependencyProperty

ValueProperty

Identifies the Value dependency property.

Declaration

public static readonly DependencyProperty ValueProperty

Field Value

Type
System.Windows.DependencyProperty

Properties

CharacterHeight

Gets or sets the height of the characters. This is a dependency property.

Declaration

public double CharacterHeight { get; set; }

Property Value

Type	Description
System.Double	Type: System.Double Default value is 30.

Remarks

The Value Should be in Positive.

Examples

using Syncfusion.UI.Xaml.Gauges; 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;

namespace TestSample { public sealed partial class MainPage : Page { public MainPage() { this.InitializeComponent(); digitalGauge.Value = " SYNCFUSION"; digitalGauge.CharacterHeight = 75;
} } }

CharactersSpacing

Gets or sets the distance between characters. This is a dependency property.

Declaration

public double CharactersSpacing { get; set; }

Property Value

Type	Description
System.Double	Type: System.Double Default value is 10.

Remarks

The Character Spacing Should be in Positive else it act as RTLFormat

Examples

namespace TestSample { public sealed partial class MainPage : Page { public MainPage() { this.InitializeComponent(); digitalGauge.Value = " SYNCFUSION"; digitalGauge.CharactersSpacing = 50;
} } }

CharacterStroke

Gets or sets the brush used to color the bright segments.This is a dependency property.

Declaration

public Brush CharacterStroke { get; set; }

Property Value

Type	Description
System.Windows.Media.Brush	Type: System.Windows.Media.Brush Default value is Red

Examples

using Syncfusion.UI.Xaml.Gauges; using System; using System.Collections.Generic; using System.IO; using System.Linq; using Windows.Foundation; using Windows.Foundation.Collections; using Windows.UI; 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;

namespace TestSample { public sealed partial class MainPage : Page { public MainPage() { this.InitializeComponent(); digitalGauge.Value = " SYNCFUSION"; digitalGauge.CharacterStroke = new SolidColorBrush(Colors.Yellow);
} } }

CharacterType

Gets or sets the value indicating whether character should contain seven or fourteen segments or sixteen segment or in Eight cross Eight Matrix. This is a dependency property.

Declaration

public CharacterType CharacterType { get; set; }

Property Value

Type	Description
CharacterType	Type: CharacterType Default value is CharacterType.SegmentSeven.

Examples

CharacterWidth

Gets or sets the width of the characters. This is a dependency property.

Declaration

public double CharacterWidth { get; set; }

Property Value

Type	Description
System.Double	Type: System.Double Default value is 30.

Remarks

The Value Should be in Positive.

Examples

namespace TestSample { public sealed partial class MainPage : Page { public MainPage() { this.InitializeComponent(); digitalGauge.Value = " SYNCFUSION"; digitalGauge.CharacterWidth = 75;
} } }

DimmedBrush

Gets or sets the brush used to color the dimmed segments.This is a dependency property.

Declaration

public Brush DimmedBrush { get; set; }

Property Value

Type	Description
System.Windows.Media.Brush	Type: System.Windows.Media.Brush Default value is Transparent

Examples

using Syncfusion.UI.Xaml.Gauges; using System; using System.Collections.Generic; using System.IO; using System.Linq; using Windows.Foundation; using Windows.Foundation.Collections; using Windows.UI; 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;

namespace TestSample { public sealed partial class MainPage : Page { public MainPage() { this.InitializeComponent(); digitalGauge.Value = " SYNCFUSION"; digitalGauge.DimmedBrush = new SolidColorBrush(Colors.White);
} } }

DimmedBrushOpacity

Gets or sets the opacity for the dimmed segments. This is a dependency property.

Declaration

public double DimmedBrushOpacity { get; set; }

Property Value

Type	Description
System.Double	Type : System.Double Default value is 50

Remarks

The property gets and sets the percentage of opacity to be set in the dimmed segments.

Examples

using Syncfusion.UI.Xaml.Gauges; using System; using System.Collections.Generic; using System.IO; using System.Linq; using Windows.Foundation; using Windows.Foundation.Collections; using Windows.UI; 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;

EnableRTLFormat

Gets or sets a value indicating whether the control should enable Right To Left support or not. This is a dependency Property.

Declaration

public bool EnableRTLFormat { get; set; }

Property Value

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

Remarks

Default value for EnableRTLFormat is False

Examples

namespace TestSample { public sealed partial class MainPage : Page { public MainPage() { this.InitializeComponent(); digitalGauge.Value = " SYNCFUSION"; digitalGauge.EnableRTLFormat = true; } } }

SegmentThickness

Gets or sets the thickness of character segments. This is a dependency property.

Declaration

public double SegmentThickness { get; set; }

Property Value

Type	Description
System.Double	Type: System.Double Default value is 2.

Remarks

It does not supports for Eight Cross Eight Segment. If the Segment thickness is negative then it will set the value as 2, if 0 the character is not visible. It also depends on CharacterHeight and CharacterWidth Properties.

Examples

using Syncfusion.UI.Xaml.Gauges; using System; using System.Collections.Generic; using System.IO; using System.Linq; using Windows.Foundation; using Windows.Foundation.Collections; using Windows.UI; 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;

namespace TestSample { public sealed partial class MainPage : Page { public MainPage() { this.InitializeComponent(); digitalGauge.Value = " SYNCFUSION"; digitalGauge.SegmentThickness = 3;
} } }

SkewAngleX

Gets or sets the angle to skew the characters along the x-axis. This is a dependency property.

Declaration

public double SkewAngleX { get; set; }

Property Value

Type	Description
System.Double	Type: System.Double Default value is 0.

Examples

using Syncfusion.UI.Xaml.Gauges; using System; using System.Collections.Generic; using System.IO; using System.Linq; using Windows.Foundation; using Windows.Foundation.Collections; using Windows.UI; 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;

namespace TestSample { public sealed partial class MainPage : Page { public MainPage() { this.InitializeComponent(); digitalGauge.Value = " SYNCFUSION"; digitalGauge.SkewAngleX = 20;
} } }

SkewAngleY

Gets or sets the angle to skew the characters along the y-axis. This is a dependency property.

Declaration

public double SkewAngleY { get; set; }

Property Value

Type	Description
System.Double	Type: System.Double Default value is 0.

Examples

using Syncfusion.UI.Xaml.Gauges; using System; using System.Collections.Generic; using System.IO; using System.Linq; using Windows.Foundation; using Windows.Foundation.Collections; using Windows.UI; 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;

namespace TestSample { public sealed partial class MainPage : Page { public MainPage() { this.InitializeComponent(); digitalGauge.Value = " SYNCFUSION"; digitalGauge.SkewAngleY = 25;
} } }

Value

Gets or sets the value that digital gauge should display. This is a dependency property.

Declaration

public string Value { get; set; }

Property Value

Type	Description
System.String	Type: System.Object

Examples

namespace TestSample { public sealed partial class MainPage : Page { public MainPage() { this.InitializeComponent(); digitalGauge.Value = " SYNCFUSION"; } } }

Methods

Dispose()

Declaration

public void Dispose()

MeasureOverride(Size)

Measures the size required for the SfDigitalGauge control.

Declaration

protected override Size MeasureOverride(Size constraint)

Parameters

Type	Name	Description
System.Windows.Size	constraint	The available size of the control.

Returns

Type	Description
System.Windows.Size	The size of the SfDigitalGauge control.

OnCharacterHeightChanged(DependencyPropertyChangedEventArgs)

Updates property value cache and raises CharacterHeightChanged event.

Declaration

protected virtual void OnCharacterHeightChanged(DependencyPropertyChangedEventArgs e)

Parameters

Type	Name	Description
System.Windows.DependencyPropertyChangedEventArgs	e	Property change details, such as old value and new value.

OnCharactersSpacingChanged(DependencyPropertyChangedEventArgs)

Updates property value cache and raises CharacterSpacingChanged event.

Declaration

protected virtual void OnCharactersSpacingChanged(DependencyPropertyChangedEventArgs e)

Parameters

Type	Name	Description
System.Windows.DependencyPropertyChangedEventArgs	e	Property change details, such as old value and new value.

OnCharacterStrokeChanged(DependencyPropertyChangedEventArgs)

Updates property value cache and raises CharacterStrokeChanged event.

Declaration

protected virtual void OnCharacterStrokeChanged(DependencyPropertyChangedEventArgs e)

Parameters

Type	Name	Description
System.Windows.DependencyPropertyChangedEventArgs	e	Property change details, such as old value and new value.

OnCharacterWidthChanged(DependencyPropertyChangedEventArgs)

Updates property value cache and raises CharacterWidthChanged event.

Declaration

protected virtual void OnCharacterWidthChanged(DependencyPropertyChangedEventArgs e)

Parameters

Type	Name	Description
System.Windows.DependencyPropertyChangedEventArgs	e	Property change details, such as old value and new value.

OnDimmedBrushChanged(DependencyPropertyChangedEventArgs)

Updates property value cache and raises DimmedBrushChanged event.

Declaration

protected virtual void OnDimmedBrushChanged(DependencyPropertyChangedEventArgs e)

Parameters

Type	Name	Description
System.Windows.DependencyPropertyChangedEventArgs	e	Property change details, such as old value and new value.

OnDimmedBrushOpacityChanged(DependencyPropertyChangedEventArgs)

Updates property value cache and raises DimmedBrushOpacityChanged event.

Declaration

protected virtual void OnDimmedBrushOpacityChanged(DependencyPropertyChangedEventArgs e)

Parameters

Type	Name	Description
System.Windows.DependencyPropertyChangedEventArgs	e	Property change details, such as old value and new value.

OnEnableRTLFormatChanged(DependencyPropertyChangedEventArgs)

Calls OnEnableRTLFormatChanged method of the instance, notifies of the dependency property EnableRTLFormat changes.

Declaration

protected virtual void OnEnableRTLFormatChanged(DependencyPropertyChangedEventArgs e)

Parameters

Type	Name	Description
System.Windows.DependencyPropertyChangedEventArgs	e	Property change details, such as old value and new value.

OnSegmentThicknessChanged(DependencyPropertyChangedEventArgs)

Updates property value cache and raises SegmentThicknessChanged event.

Declaration

protected virtual void OnSegmentThicknessChanged(DependencyPropertyChangedEventArgs e)

Parameters

Type	Name	Description
System.Windows.DependencyPropertyChangedEventArgs	e	Property change details, such as old value and new value.

OnSkewAngleXChanged(DependencyPropertyChangedEventArgs)

Updates property value cache and raises SkewAngleXChanged event.

Declaration

protected virtual void OnSkewAngleXChanged(DependencyPropertyChangedEventArgs e)

Parameters

Type	Name	Description
System.Windows.DependencyPropertyChangedEventArgs	e	Property change details, such as old value and new value.

OnSkewAngleYChanged(DependencyPropertyChangedEventArgs)

Updates property value cache and raises SkewAngleYChanged event.

Declaration

protected virtual void OnSkewAngleYChanged(DependencyPropertyChangedEventArgs e)

Parameters

Type	Name	Description
System.Windows.DependencyPropertyChangedEventArgs	e	Property change details, such as old value and new value.

OnValueChanged(DependencyPropertyChangedEventArgs)

Updates property value cache and raises ValueChanged event.

Declaration

protected virtual void OnValueChanged(DependencyPropertyChangedEventArgs e)

Parameters

Type	Name	Description
System.Windows.DependencyPropertyChangedEventArgs	e	Property change details, such as old value and new value.

Events

CharacterHeightChanged

Event that is raised when CharacterHeight property is changed.

Declaration

public event PropertyChangedCallback CharacterHeightChanged

Event Type

Type
System.Windows.PropertyChangedCallback

CharactersSpacingChanged

Event that is raised when CharactersSpacing property is changed.

Declaration

public event PropertyChangedCallback CharactersSpacingChanged

Event Type

Type
System.Windows.PropertyChangedCallback

CharacterStrokeChanged

Event that is raised when CharacterStroke property is changed.

Declaration

public event PropertyChangedCallback CharacterStrokeChanged

Event Type

Type
System.Windows.PropertyChangedCallback

CharacterTypeChanged

Event that is raised when CharacterType property is changed.

Declaration

public event PropertyChangedCallback CharacterTypeChanged

Event Type

Type
System.Windows.PropertyChangedCallback

CharacterWidthChanged

Event that is raised when CharacterWidth property is changed.

Declaration

public event PropertyChangedCallback CharacterWidthChanged

Event Type

Type
System.Windows.PropertyChangedCallback

DimmedBrushChanged

Event that is raised when DimmedBrush property is changed.

Declaration

public event PropertyChangedCallback DimmedBrushChanged

Event Type

Type
System.Windows.PropertyChangedCallback

DimmedBrushOpacityChanged

Event that is raised when DimmedBrushOpacity property is changed.

Declaration

public event PropertyChangedCallback DimmedBrushOpacityChanged

Event Type

Type
System.Windows.PropertyChangedCallback

EnableRTLFormatChanged

Event that is raised when EnableRTLFormat property is changed.

Declaration

public event PropertyChangedCallback EnableRTLFormatChanged

Event Type

Type
System.Windows.PropertyChangedCallback

SegmentThicknessChanged

Event that is raised when SegmentThickness property is changed.

Declaration

public event PropertyChangedCallback SegmentThicknessChanged

Event Type

Type
System.Windows.PropertyChangedCallback

SkewAngleXChanged

Event that is raised when SkewAngleX property is changed.

Declaration

public event PropertyChangedCallback SkewAngleXChanged

Event Type

Type
System.Windows.PropertyChangedCallback

SkewAngleYChanged

Event that is raised when SkewAngleY property is changed.

Declaration

public event PropertyChangedCallback SkewAngleYChanged

Event Type

Type
System.Windows.PropertyChangedCallback

ValueChanged

Event that is raised when Value property is changed.

Declaration

public event PropertyChangedCallback ValueChanged

Event Type

Type
System.Windows.PropertyChangedCallback

Implements

System.IDisposable