Class LinearPointer
Represents the linear pointer. To render this pointer, create an instance of the LinearPointer class, and set required properties.
Inheritance
Namespace: Syncfusion.UI.Xaml.Gauges
Assembly: Syncfusion.SfGauge.WPF.dll
Syntax
public class LinearPointer : ControlConstructors
LinearPointer()
Initializes a new instance of the LinearPointer class.
Declaration
public LinearPointer()Fields
AnimationDurationProperty
Declaration
public static readonly DependencyProperty AnimationDurationPropertyField Value
| Type |
|---|
| System.Windows.DependencyProperty |
BarPointerStartProperty
The dependency property for BarPointerStart property.
Declaration
public static readonly DependencyProperty BarPointerStartPropertyField Value
| Type |
|---|
| System.Windows.DependencyProperty |
BarPointerStrokeProperty
Using a DependencyProperty as the backing store for BarPointerStroke. This enables animation, styling, binding, etc...
Declaration
public static readonly DependencyProperty BarPointerStrokePropertyField Value
| Type |
|---|
| System.Windows.DependencyProperty |
BarPointerStrokeThicknessProperty
Using a DependencyProperty as the backing store for BarPointerStrokeThickness. This enables animation, styling, binding, etc...
Declaration
public static readonly DependencyProperty BarPointerStrokeThicknessPropertyField Value
| Type |
|---|
| System.Windows.DependencyProperty |
EnableAnimationProperty
Using a DependencyProperty as the backing store for EnableAnimation. This enables animation, styling, binding, etc...
Declaration
public static readonly DependencyProperty EnableAnimationPropertyField Value
| Type |
|---|
| System.Windows.DependencyProperty |
PointerPositionFactorProperty
Using a DependencyProperty as the backing store for PointerPositionFactor. This enables animation, styling, binding, etc...
Declaration
public static readonly DependencyProperty PointerPositionFactorPropertyField Value
| Type |
|---|
| System.Windows.DependencyProperty |
PointerTypeProperty
Using a DependencyProperty as the backing store for PointerType. This enables animation, styling, binding, etc...
Declaration
public static readonly DependencyProperty PointerTypePropertyField Value
| Type |
|---|
| System.Windows.DependencyProperty |
ShowPointerProperty
Using a DependencyProperty as the backing store for ShowPointer. This enables animation, styling, binding, etc...
Declaration
public static readonly DependencyProperty ShowPointerPropertyField Value
| Type |
|---|
| System.Windows.DependencyProperty |
SymbolPointerHeightProperty
Using a DependencyProperty as the backing store for SymbolPointerHeight. This enables animation, styling, binding, etc...
Declaration
public static readonly DependencyProperty SymbolPointerHeightPropertyField Value
| Type |
|---|
| System.Windows.DependencyProperty |
SymbolPointerPositionProperty
Using a DependencyProperty as the backing store for SymbolPointerPosition. This enables animation, styling, binding, etc...
Declaration
public static readonly DependencyProperty SymbolPointerPositionPropertyField Value
| Type |
|---|
| System.Windows.DependencyProperty |
SymbolPointerStrokeProperty
Using a DependencyProperty as the backing store for SymbolPointerStroke. This enables animation, styling, binding, etc...
Declaration
public static readonly DependencyProperty SymbolPointerStrokePropertyField Value
| Type |
|---|
| System.Windows.DependencyProperty |
SymbolPointerStyleProperty
Using a DependencyProperty as the backing store for SymbolPointerStyle. This enables animation, styling, binding, etc...
Declaration
public static readonly DependencyProperty SymbolPointerStylePropertyField Value
| Type |
|---|
| System.Windows.DependencyProperty |
SymbolPointerTemplateProperty
Using a DependencyProperty as the backing store for SymbolPointerTemplate. This enables animation, styling, binding, etc...
Declaration
public static readonly DependencyProperty SymbolPointerTemplatePropertyField Value
| Type |
|---|
| System.Windows.DependencyProperty |
SymbolPointerWidthProperty
Using a DependencyProperty as the backing store for SymbolPointerWidth. This enables animation, styling, binding, etc...
Declaration
public static readonly DependencyProperty SymbolPointerWidthPropertyField Value
| Type |
|---|
| System.Windows.DependencyProperty |
ValueProperty
Using a DependencyProperty as the backing store for Value. This enables animation, styling, binding, etc...
Declaration
public static readonly DependencyProperty ValuePropertyField Value
| Type |
|---|
| System.Windows.DependencyProperty |
Properties
AnimationDuration
Gets or sets the duration of the pointer animation in milliseconds.
Declaration
public int AnimationDuration { get; set; }Property Value
| Type | Description |
|---|---|
| System.Int32 | An integer denotes the duration of animation in milliseconds. The default value is |
Examples
using Syncfusion.UI.Xaml.Gauges;
namespace GaugeSample
{
public sealed partial class LinearGauge
{
public LinearGauge()
{
InitializeComponent();
SfLinearGauge linearGauge = new SfLinearGauge();
LinearPointer linearPointer = new LinearPointer();
linearPointer.Value = 25;
linearPointer.EnableAnimation = true;
linearPointer.AnimationDuration = 2000;
linearGauge.MainScale = new LinearScale();
linearGauge.MainScale.Pointers.Add(linearPointer);
this.Layout.Children.Add(linearGauge);
}
}
}
BarPointerStart
Gets or sets the start value for the bar pointer.
Declaration
public double BarPointerStart { get; set; }Property Value
| Type |
|---|
| System.Double |
BarPointerStroke
Gets or sets the color of bar pointer.
Declaration
public Brush BarPointerStroke { get; set; }Property Value
| Type |
|---|
| System.Windows.Media.Brush |
Examples
using Syncfusion.UI.Xaml.Gauges;
using Windows.UI;
using Windows.UI.Xaml.Media;
namespace GaugeSample
{
public sealed partial class LinearGauge
{
public LinearGauge()
{
InitializeComponent();
SfLinearGauge linearGauge = new SfLinearGauge();
LinearPointer linearPointer = new LinearPointer();
linearPointer.Value = 25;
linearPointer.PointerType = LinearPointerType.BarPointer;
linearPointer.BarPointerStroke = new SolidColorBrush(Colors.Red);
linearGauge.MainScale = new LinearScale();
linearGauge.MainScale.Pointers.Add(linearPointer);
this.Layout.Children.Add(linearGauge);
}
}
}
BarPointerStrokeThickness
Gets or sets the thickness of bar pointer.
Declaration
public double BarPointerStrokeThickness { get; set; }Property Value
| Type |
|---|
| System.Double |
Examples
using Syncfusion.UI.Xaml.Gauges;
namespace GaugeSample
{
public sealed partial class LinearGauge
{
public LinearGauge()
{
InitializeComponent();
SfLinearGauge linearGauge = new SfLinearGauge();
LinearPointer linearPointer = new LinearPointer();
linearPointer.Value = 25;
linearPointer.PointerType = LinearPointerType.BarPointer;
linearPointer.BarPointerStrokeThickness = 15;
linearGauge.MainScale = new LinearScale();
linearGauge.MainScale.Pointers.Add(linearPointer);
this.Layout.Children.Add(linearGauge);
}
}
}
EnableAnimation
Gets or sets a value indicating whether the animation for pointers in linear scale should be enabled or not.
Declaration
public bool EnableAnimation { get; set; }Property Value
| Type |
|---|
| System.Boolean |
Examples
using Syncfusion.UI.Xaml.Gauges;
namespace GaugeSample
{
public sealed partial class LinearGauge
{
public LinearGauge()
{
InitializeComponent();
SfLinearGauge linearGauge = new SfLinearGauge();
LinearPointer linearPointer = new LinearPointer();
linearPointer.Value = 25;
linearPointer.EnableAnimation = true;
linearGauge.MainScale = new LinearScale();
linearGauge.MainScale.Pointers.Add(linearPointer);
this.Layout.Children.Add(linearGauge);
}
}
}
PointerPositionFactor
Gets or sets the factor value to position pointers based upon the scale.
Declaration
public double PointerPositionFactor { get; set; }Property Value
| Type |
|---|
| System.Double |
Remarks
It shows effect only if ElementsPosition of linear scale is set as Custom.
Examples
using Syncfusion.UI.Xaml.Gauges;
namespace GaugeSample
{
public sealed partial class LinearGauge
{
public LinearGauge()
{
InitializeComponent();
SfLinearGauge linearGauge = new SfLinearGauge();
LinearPointer linearPointer = new LinearPointer();
linearPointer.Value = 25;
linearPointer.PointerPositionFactor = 0.5;
linearGauge.MainScale = new LinearScale();
linearGauge.MainScale.Pointers.Add(linearPointer);
this.Layout.Children.Add(linearGauge);
}
}
}
PointerType
Gets or sets the type of pointer in the linear scale.
Declaration
public LinearPointerType PointerType { get; set; }Property Value
| Type |
|---|
| LinearPointerType |
Examples
using Syncfusion.UI.Xaml.Gauges;
namespace GaugeSample
{
public sealed partial class LinearGauge
{
public LinearGauge()
{
InitializeComponent();
SfLinearGauge linearGauge = new SfLinearGauge();
LinearPointer linearPointer = new LinearPointer();
linearPointer.Value = 25;
linearPointer.PointerType = LinearPointerType.SymbolPointer;
linearGauge.MainScale = new LinearScale();
linearGauge.MainScale.Pointers.Add(linearPointer);
this.Layout.Children.Add(linearGauge);
}
}
}
ShowPointer
Gets or sets a value indicating whether the pointer should be shown or hidden.
Declaration
public bool ShowPointer { get; set; }Property Value
| Type |
|---|
| System.Boolean |
Examples
using Syncfusion.UI.Xaml.Gauges;
namespace GaugeSample
{
public sealed partial class LinearGauge
{
public LinearGauge()
{
InitializeComponent();
SfLinearGauge linearGauge = new SfLinearGauge();
LinearPointer linearPointer = new LinearPointer();
linearPointer.Value = 25;
linearPointer.ShowPointer = true;
linearGauge.MainScale = new LinearScale();
linearGauge.MainScale.Pointers.Add(linearPointer);
this.Layout.Children.Add(linearGauge);
}
}
}
SymbolPointerHeight
Gets or sets the height of the symbol pointer.
Declaration
public double SymbolPointerHeight { get; set; }Property Value
| Type |
|---|
| System.Double |
Examples
using Syncfusion.UI.Xaml.Gauges;
namespace GaugeSample
{
public sealed partial class LinearGauge
{
public LinearGauge()
{
InitializeComponent();
SfLinearGauge linearGauge = new SfLinearGauge();
LinearPointer linearPointer = new LinearPointer();
linearPointer.Value = 25;
linearPointer.PointerType = LinearPointerType.SymbolPointer;
linearPointer.SymbolPointerHeight = 50;
linearGauge.MainScale = new LinearScale();
linearGauge.MainScale.Pointers.Add(linearPointer);
this.Layout.Children.Add(linearGauge);
}
}
}
SymbolPointerPosition
Gets or sets the position of the symbol pointer.
Declaration
public LinearSymbolPointersPosition SymbolPointerPosition { get; set; }Property Value
| Type |
|---|
| LinearSymbolPointersPosition |
Examples
using Syncfusion.UI.Xaml.Gauges;
namespace GaugeSample
{
public sealed partial class LinearGauge
{
public LinearGauge()
{
InitializeComponent();
SfLinearGauge linearGauge = new SfLinearGauge();
LinearPointer linearPointer = new LinearPointer();
linearPointer.Value = 25;
linearPointer.PointerType = LinearPointerType.SymbolPointer;
linearPointer.SymbolPointerPosition = LinearSymbolPointersPosition.Above;
linearGauge.MainScale = new LinearScale();
linearGauge.MainScale.Pointers.Add(linearPointer);
this.Layout.Children.Add(linearGauge);
}
}
}
SymbolPointerStroke
Gets or sets the color of the symbol pointer.
Declaration
public Brush SymbolPointerStroke { get; set; }Property Value
| Type |
|---|
| System.Windows.Media.Brush |
Examples
using Syncfusion.UI.Xaml.Gauges;
using Windows.UI;
using Windows.UI.Xaml.Media;
namespace GaugeSample
{
public sealed partial class LinearGauge
{
public LinearGauge()
{
InitializeComponent();
SfLinearGauge linearGauge = new SfLinearGauge();
LinearPointer linearPointer = new LinearPointer();
linearPointer.Value = 25;
linearPointer.PointerType = LinearPointerType.SymbolPointer;
linearPointer.SymbolPointerStroke = new SolidColorBrush(Colors.Red);
linearGauge.MainScale = new LinearScale();
linearGauge.MainScale.Pointers.Add(linearPointer);
this.Layout.Children.Add(linearGauge);
}
}
}
SymbolPointerStyle
Gets or sets the style of the symbol pointer.
Declaration
public LinearSymbolPointerStyle SymbolPointerStyle { get; set; }Property Value
| Type |
|---|
| LinearSymbolPointerStyle |
Examples
using Syncfusion.UI.Xaml.Gauges;
namespace GaugeSample
{
public sealed partial class LinearGauge
{
public LinearGauge()
{
InitializeComponent();
SfLinearGauge linearGauge = new SfLinearGauge();
LinearPointer linearPointer = new LinearPointer();
linearPointer.Value = 25;
linearPointer.PointerType = LinearPointerType.SymbolPointer;
linearPointer.SymbolPointerStyle = LinearSymbolPointerStyle.Triangle;
linearGauge.MainScale = new LinearScale();
linearGauge.MainScale.Pointers.Add(linearPointer);
this.Layout.Children.Add(linearGauge);
}
}
}
SymbolPointerTemplate
Gets or sets the template for customizing the symbol pointer.
Declaration
public DataTemplate SymbolPointerTemplate { get; set; }Property Value
| Type |
|---|
| System.Windows.DataTemplate |
Remarks
To customize the symbol pointer SymbolPointerStyle of linear pointer should be set as Custom.
Examples
using Syncfusion.UI.Xaml.Gauges;
using Windows.UI.Xaml;
namespace GaugeSample
{
public sealed partial class LinearGauge
{
public LinearGauge()
{
InitializeComponent();
SfLinearGauge linearGauge = new SfLinearGauge();
LinearPointer linearPointer = new LinearPointer();
linearPointer.Value = 25;
linearPointer.PointerType = LinearPointerType.SymbolPointer;
linearPointer.SymbolPointerStyle = LinearSymbolPointerStyle.Custom;
linearPointer.SymbolPointerTemplate = this.Resources["EllipseSymbolTemplateKey"] as DataTemplate;
linearGauge.MainScale = new LinearScale();
linearGauge.MainScale.Pointers.Add(linearPointer);
this.Layout.Children.Add(linearGauge);
}
}
}
SymbolPointerWidth
Gets or sets the width of the symbol pointer.
Declaration
public double SymbolPointerWidth { get; set; }Property Value
| Type |
|---|
| System.Double |
Examples
using Syncfusion.UI.Xaml.Gauges;
namespace GaugeSample
{
public sealed partial class LinearGauge
{
public LinearGauge()
{
InitializeComponent();
SfLinearGauge linearGauge = new SfLinearGauge();
LinearPointer linearPointer = new LinearPointer();
linearPointer.Value = 25;
linearPointer.PointerType = LinearPointerType.SymbolPointer;
linearPointer.SymbolPointerWidth = 30;
linearGauge.MainScale = new LinearScale();
linearGauge.MainScale.Pointers.Add(linearPointer);
this.Layout.Children.Add(linearGauge);
}
}
}
Value
Gets or sets the value for pointer in the linear gauge.
Declaration
public double Value { get; set; }Property Value
| Type |
|---|
| System.Double |
Examples
using Syncfusion.UI.Xaml.Gauges;
namespace GaugeSample
{
public sealed partial class LinearGauge
{
public LinearGauge()
{
InitializeComponent();
SfLinearGauge linearGauge = new SfLinearGauge();
LinearPointer linearPointer = new LinearPointer();
linearPointer.Value = 25;
linearGauge.MainScale = new LinearScale();
linearGauge.MainScale.Pointers.Add(linearPointer);
this.Layout.Children.Add(linearGauge);
}
}
}