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.

Inheritance
System.Object
GaugePointer
MarkerPointer
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

Dependency registration for BorderWidth property.

Declaration
public static readonly DependencyProperty BorderWidthProperty
Field Value
Type Description
Microsoft.UI.Xaml.DependencyProperty

ImageSourceProperty

Dependency registration for ImageSource property.

Declaration
public static readonly DependencyProperty ImageSourceProperty
Field Value
Type Description
Microsoft.UI.Xaml.DependencyProperty

MarkerHeightProperty

Dependency registration for MarkerHeight property.

Declaration
public static readonly DependencyProperty MarkerHeightProperty
Field Value
Type Description
Microsoft.UI.Xaml.DependencyProperty

MarkerOffsetProperty

Dependency registration for MarkerOffset property.

Declaration
public static readonly DependencyProperty MarkerOffsetProperty
Field Value
Type Description
Microsoft.UI.Xaml.DependencyProperty

MarkerTemplateProperty

Dependency registration for MarkerTemplate property.

Declaration
public static readonly DependencyProperty MarkerTemplateProperty
Field Value
Type Description
Microsoft.UI.Xaml.DependencyProperty

MarkerTypeProperty

Dependency registration for MarkerType property.

Declaration
public static readonly DependencyProperty MarkerTypeProperty
Field Value
Type Description
Microsoft.UI.Xaml.DependencyProperty

MarkerWidthProperty

Dependency registration for MarkerWidth property.

Declaration
public static readonly DependencyProperty MarkerWidthProperty
Field Value
Type Description
Microsoft.UI.Xaml.DependencyProperty

OffsetUnitProperty

Dependency registration for OffsetUnit property.

Declaration
public static readonly DependencyProperty OffsetUnitProperty
Field Value
Type Description
Microsoft.UI.Xaml.DependencyProperty

TextProperty

Dependency registration for Text property.

Declaration
public static readonly DependencyProperty TextProperty
Field Value
Type Description
Microsoft.UI.Xaml.DependencyProperty

Properties

BorderWidth

Gets or sets the width of the marker border outline.

Declaration
public double BorderWidth { get; set; }
Property Value
Type Description
System.Double
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
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
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
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
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
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
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
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
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.