Class MarkerPointer
Create the pointer to indicate the value with built-in shape. To highlight values, set the marker pointer type to a built-in shape, such as a circle, text, image, triangle, inverted triangle, square, or diamond.
Inherited Members
Namespace: Syncfusion.UI.Xaml.Gauges
Assembly: Syncfusion.Gauge.WinUI.dll
Syntax
public class MarkerPointer : GaugePointer
Examples
<gauge:SfRadialGauge>
<gauge:SfRadialGauge.Axes>
<gauge:RadialAxis>
<gauge:RadialAxis.Pointers>
<gauge:MarkerPointer Value = "50" />
</ gauge:RadialAxis.Pointers>
</gauge:RadialAxis>
</gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>
Constructors
MarkerPointer()
Initializes a new instance of the MarkerPointer class.
Declaration
public MarkerPointer()
Fields
BorderWidthProperty
Identifies the BorderWidth dependency property.
Declaration
public static readonly DependencyProperty BorderWidthProperty
Field Value
Type | Description |
---|---|
Microsoft.UI.Xaml.DependencyProperty | The identifier for BorderWidth dependency property. |
ImageSourceProperty
Identifies the ImageSource dependency property.
Declaration
public static readonly DependencyProperty ImageSourceProperty
Field Value
Type | Description |
---|---|
Microsoft.UI.Xaml.DependencyProperty | The identifier for ImageSource dependency property. |
MarkerHeightProperty
Identifies the MarkerHeight dependency property.
Declaration
public static readonly DependencyProperty MarkerHeightProperty
Field Value
Type | Description |
---|---|
Microsoft.UI.Xaml.DependencyProperty | The identifier for MarkerHeight dependency property. |
MarkerOffsetProperty
Identifies the MarkerOffset dependency property.
Declaration
public static readonly DependencyProperty MarkerOffsetProperty
Field Value
Type | Description |
---|---|
Microsoft.UI.Xaml.DependencyProperty | The identifier for MarkerOffset dependency property. |
MarkerTemplateProperty
Identifies the MarkerTemplate dependency property.
Declaration
public static readonly DependencyProperty MarkerTemplateProperty
Field Value
Type | Description |
---|---|
Microsoft.UI.Xaml.DependencyProperty | The identifier for MarkerTemplate dependency property. |
MarkerTypeProperty
Identifies the MarkerType dependency property.
Declaration
public static readonly DependencyProperty MarkerTypeProperty
Field Value
Type | Description |
---|---|
Microsoft.UI.Xaml.DependencyProperty | The identifier for MarkerType dependency property. |
MarkerWidthProperty
Identifies the MarkerWidth dependency property.
Declaration
public static readonly DependencyProperty MarkerWidthProperty
Field Value
Type | Description |
---|---|
Microsoft.UI.Xaml.DependencyProperty | The identifier for MarkerWidth dependency property. |
OffsetUnitProperty
Identifies the OffsetUnit dependency property.
Declaration
public static readonly DependencyProperty OffsetUnitProperty
Field Value
Type | Description |
---|---|
Microsoft.UI.Xaml.DependencyProperty | The identifier for OffsetUnit dependency property. |
TextProperty
Identifies the Text dependency property.
Declaration
public static readonly DependencyProperty TextProperty
Field Value
Type | Description |
---|---|
Microsoft.UI.Xaml.DependencyProperty | The identifier for Text dependency property. |
Properties
BorderWidth
Gets or sets the width of the marker border outline.
Declaration
public double BorderWidth { get; set; }
Property Value
Type | Description |
---|---|
System.Double | It defines the thickness of the border. The default value is |
Examples
<gauge:SfRadialGauge>
<gauge:SfRadialGauge.Axes>
<gauge:RadialAxis>
<gauge:RadialAxis.Pointers>
<gauge:MarkerPointer BorderWidth="2" />
</ gauge:RadialAxis.Pointers>
</gauge:RadialAxis>
</gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>
ImageSource
Gets or sets the image Url source.
Declaration
public ImageSource ImageSource { get; set; }
Property Value
Type | Description |
---|---|
Microsoft.UI.Xaml.Media.ImageSource | It defines the image path of the marker when MarkerType is Image.
The default value is |
Examples
<gauge:SfRadialGauge>
<gauge:SfRadialGauge.Axes>
<gauge:RadialAxis>
<gauge:RadialAxis.Pointers>
<gauge:MarkerPointer ImageSource="/Images/Cloud.png" />
</ gauge:RadialAxis.Pointers>
</gauge:RadialAxis>
</gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>
MarkerHeight
Gets or sets a value that specifies the marker height in logical pixels.
Declaration
public double MarkerHeight { get; set; }
Property Value
Type | Description |
---|---|
System.Double | It defines the height of the marker. The default value is |
Examples
<gauge:SfRadialGauge>
<gauge:SfRadialGauge.Axes>
<gauge:RadialAxis>
<gauge:RadialAxis.Pointers>
<gauge:MarkerPointer MarkerHeight="2" />
</ gauge:RadialAxis.Pointers>
</gauge:RadialAxis>
</gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>
MarkerOffset
Gets or sets a value that specifies the marker position value either in logical pixel or radius factor.
Declaration
public double MarkerOffset { get; set; }
Property Value
Type | Description |
---|---|
System.Double | It defines the position offset of the marker either pixel or factor. The default value is |
Examples
If OffsetUnit is Factor, value will be given from 0 to 1. Here pointer placing position is calculated by MarkerOffset * axis radius value. Example: MarkerOffset value is 0.2 and axis radius is 100, pointer is moving 20(0.2 * 100) logical pixels from axis outer radius. If OffsetUnit is Pixel, defined value distance pointer will move from the outer radius axis. When you specify MarkerOffset is negative, the pointer will be positioned outside the axis.
<gauge:SfRadialGauge>
<gauge:SfRadialGauge.Axes>
<gauge:RadialAxis>
<gauge:RadialAxis.Pointers>
<gauge:MarkerPointer MarkerOffset="0.2" />
</ gauge:RadialAxis.Pointers>
</gauge:RadialAxis>
</gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>
MarkerTemplate
Gets or sets the data template to customizes the marker shape.
Declaration
public DataTemplate MarkerTemplate { get; set; }
Property Value
Type | Description |
---|---|
Microsoft.UI.Xaml.DataTemplate | The template for the marker pointer. The default is |
Remarks
Its DataContext is MarkerPointer.
Examples
<gauge:SfRadialGauge>
<gauge:SfRadialGauge.Axes>
<gauge:RadialAxis>
<gauge:RadialAxis.Pointers>
<gauge:MarkerPointer Value="50" >
< gauge:MarkerPointer.MarkerTemplate>
<DataTemplate>
<Grid>
<Rectangle Fill = "{Binding Background}"
Stroke="{Binding BorderBrush}"
StrokeThickness="{Binding BorderWidth}"
Width="{Binding MarkerWidth}"
Height="{Binding MarkerHeight}"
RadiusX="3"
RadiusY="3" />
</Grid>
</DataTemplate>
</gauge:MarkerPointer.MarkerTemplate>
</gauge:MarkerPointer>
</gauge:RadialAxis.Pointers>
</gauge:RadialAxis>
</gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>
MarkerType
Gets or sets a value that specifies the marker type for the pointer.
Declaration
public MarkerType MarkerType { get; set; }
Property Value
Type | Description |
---|---|
MarkerType | One of the enumeration values that specifies the marker type of marker pointer in the radial gauge. The default is InvertedTriangle. |
Examples
<gauge:SfRadialGauge>
<gauge:SfRadialGauge.Axes>
<gauge:RadialAxis>
<gauge:RadialAxis.Pointers>
<gauge:MarkerPointer MarkerType="Triangle" />
</ gauge:RadialAxis.Pointers>
</gauge:RadialAxis>
</gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>
MarkerWidth
Gets or sets a value that specifies the marker width in logical pixels.
Declaration
public double MarkerWidth { get; set; }
Property Value
Type | Description |
---|---|
System.Double | It defines the width of the marker. The default value is |
Examples
<gauge:SfRadialGauge>
<gauge:SfRadialGauge.Axes>
<gauge:RadialAxis>
<gauge:RadialAxis.Pointers>
<gauge:MarkerPointer MarkerWidth="2" />
</ gauge:RadialAxis.Pointers>
</gauge:RadialAxis>
</gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>
OffsetUnit
Gets or sets the value that indicates to calculate the marker pointer offset in logical pixel or radius factor.
Declaration
public SizeUnit OffsetUnit { get; set; }
Property Value
Type | Description |
---|---|
SizeUnit | One of the SizeUnit enumeration that specifies how the MarkerOffset value is considered. The default mode is Pixel. |
Examples
<gauge:SfRadialGauge>
<gauge:SfRadialGauge.Axes>
<gauge:RadialAxis>
<gauge:RadialAxis.Pointers>
<gauge:MarkerPointer OffsetUnit="Factor" />
</ gauge:RadialAxis.Pointers>
</gauge:RadialAxis>
</gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>
Text
Gets or sets the marker text.
Declaration
public string Text { get; set; }
Property Value
Type | Description |
---|---|
System.String | It defines the string of the marker when MarkerType is Text.
The default value is |
Examples
<gauge:SfRadialGauge>
<gauge:SfRadialGauge.Axes>
<gauge:RadialAxis>
<gauge:RadialAxis.Pointers>
<gauge:MarkerPointer Text="Syncfusion" />
</ gauge:RadialAxis.Pointers>
</gauge:RadialAxis>
</gauge:SfRadialGauge.Axes>
</gauge:SfRadialGauge>
Methods
OnApplyTemplate()
Invoke to render MarkerPointer class.
Declaration
protected override void OnApplyTemplate()
OnCreateAutomationPeer()
Declaration
protected override AutomationPeer OnCreateAutomationPeer()
Returns
Type | Description |
---|---|
Microsoft.UI.Xaml.Automation.Peers.AutomationPeer |
Overrides
OnPointerPressed(PointerRoutedEventArgs)
Called when the pointer get pressed.
Declaration
protected override void OnPointerPressed(PointerRoutedEventArgs e)
Parameters
Type | Name | Description |
---|---|---|
Microsoft.UI.Xaml.Input.PointerRoutedEventArgs | e | The pointer routed event arguments. |