Class ChartTrackballBehavior

ChartTrackballBehavior enables tracking of data points nearer to mouse over position or at touch contact point in a Chart.

Inheritance

System.Object

ChartBehavior

ChartTrackballBehavior

Inherited Members

ChartBehavior.chartAxis

ChartBehavior.DetachElement(UIElement)

ChartBehavior.OnDragEnter(DragEventArgs)

ChartBehavior.OnDragLeave(DragEventArgs)

ChartBehavior.OnDragOver(DragEventArgs)

ChartBehavior.OnDrop(DragEventArgs)

ChartBehavior.OnGotFocus(RoutedEventArgs)

ChartBehavior.OnLostFocus(RoutedEventArgs)

ChartBehavior.OnDoubleTapped(DoubleTappedRoutedEventArgs)

ChartBehavior.OnKeyDown(KeyRoutedEventArgs)

ChartBehavior.OnKeyUp(KeyRoutedEventArgs)

ChartBehavior.OnManipulationCompleted(ManipulationCompletedRoutedEventArgs)

ChartBehavior.OnManipulationDelta(ManipulationDeltaRoutedEventArgs)

ChartBehavior.OnManipulationInertiaStarting(ManipulationInertiaStartingRoutedEventArgs)

ChartBehavior.OnManipulationStarted(ManipulationStartedRoutedEventArgs)

ChartBehavior.OnManipulationStarting(ManipulationStartingRoutedEventArgs)

ChartBehavior.OnPointerCanceled(PointerRoutedEventArgs)

ChartBehavior.OnPointerCaptureLost(PointerRoutedEventArgs)

ChartBehavior.OnPointerEntered(PointerRoutedEventArgs)

ChartBehavior.OnPointerWheelChanged(PointerRoutedEventArgs)

ChartBehavior.OnRightTapped(RightTappedRoutedEventArgs)

ChartBehavior.OnTapped(TappedRoutedEventArgs)

ChartBehavior.GetYValuesBasedOnIndex(Double, ChartSeriesBase)

ChartBehavior.UpdateArea()

ChartBehavior.AdorningCanvas

ChartBehavior.BottomAdorningCanvas

ChartBehavior.ChartArea

Namespace: Syncfusion.UI.Xaml.Charts

Assembly: Syncfusion.Chart.WinUI.dll

Syntax

public class ChartTrackballBehavior : ChartBehavior

Remarks

ChartTrackballBehavior displays a vertical line, a tracker ball symbol and a popup like control displaying information about the data point, at mouse move positions/ at touch contact positions over a ChartSeriesBase.

Examples

This example, we are using ChartTrackballBehavior.

    <syncfusion:SfChart>
        <syncfusion:SfChart.Behaviors>
            <syncfusion:ChartTrackballBehavior/>
        </syncfusion:SfChart.Behaviors>
    </syncfusion:SfChart>

    ChartTrackballBehavior trackball = new ChartTrackballBehavior();
    chartArea.Behaviors.Add(trackball);

Constructors

ChartTrackballBehavior()

Called when instance created for ChartTrackballBehavior.

Declaration

public ChartTrackballBehavior()

Fields

AxisLabelAlignmentProperty

The DependencyProperty for AxisLabelAlignment property.

Declaration

public static readonly DependencyProperty AxisLabelAlignmentProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty

ChartTrackballStyleProperty

The DependencyProperty for ChartTrackballStyle property.

Declaration

public static readonly DependencyProperty ChartTrackballStyleProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty

LabelDisplayModeProperty

The DependencyProperty for LabelDisplayMode property.

Declaration

public static readonly DependencyProperty LabelDisplayModeProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty

LabelHorizontalAlignmentProperty

The DependencyProperty for LabelHorizontalAlignment property.

Declaration

public static readonly DependencyProperty LabelHorizontalAlignmentProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty

LabelVerticalAlignmentProperty

The DependencyProperty for LabelVerticalAlignment property.

Declaration

public static readonly DependencyProperty LabelVerticalAlignmentProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty

LineStyleProperty

The DependencyProperty for LineStyle property.

Declaration

public static readonly DependencyProperty LineStyleProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty

ShowLineProperty

The DependencyProperty for ShowLine property.

Declaration

public static readonly DependencyProperty ShowLineProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty

UseSeriesPaletteProperty

The DependencyProperty for UseSeriesPalette property.

Declaration

public static readonly DependencyProperty UseSeriesPaletteProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty

Properties

AxisLabelAlignment

Gets or sets the alignment for the label appearing in axis.

Declaration

public ChartAlignment AxisLabelAlignment { get; set; }

Property Value

Type	Description
ChartAlignment	ChartAlignment

ChartTrackballStyle

Gets or sets the style for ChartTrackballControl.

Declaration

public Style ChartTrackballStyle { get; set; }

Property Value

Type	Description
Microsoft.UI.Xaml.Style

IsActivated

Gets or sets a value indicating whether the trackball is activated or not.

Declaration

protected bool IsActivated { get; set; }

Property Value

Type	Description
System.Boolean

LabelDisplayMode

Gets or sets the trackball display mode for label.

Declaration

public TrackballLabelDisplayMode LabelDisplayMode { get; set; }

Property Value

Type	Description
TrackballLabelDisplayMode	TrackballLabelDisplayMode

LabelHorizontalAlignment

Gets or sets horizontal alignment for label.

Declaration

public ChartAlignment LabelHorizontalAlignment { get; set; }

Property Value

Type	Description
ChartAlignment

LabelVerticalAlignment

Gets or sets vertical alignment for label.

Declaration

public ChartAlignment LabelVerticalAlignment { get; set; }

Property Value

Type	Description
ChartAlignment

LineStyle

Gets or sets the trackball line style.

Declaration

public Style LineStyle { get; set; }

Property Value

Type	Description
Microsoft.UI.Xaml.Style

PointInfos

Gets the collection of ChartPointInfo.

Declaration

public ObservableCollection<ChartPointInfo> PointInfos { get; }

Property Value

Type	Description
System.Collections.ObjectModel.ObservableCollection<ChartPointInfo>

ShowLine

Gets or sets a value indicating whether to show/hide line.

Declaration

public bool ShowLine { get; set; }

Property Value

Type	Description
System.Boolean

UseSeriesPalette

Gets or sets a value indicating whether to change the color for the labels according to the series color.

Declaration

public bool UseSeriesPalette { get; set; }

Property Value

Type	Description
System.Boolean

Methods

AddElement(UIElement)

Method implementation for adding UIElement.

Declaration

protected void AddElement(UIElement element)

Parameters

Type	Name	Description
Microsoft.UI.Xaml.UIElement	element	UIElement

AddGroupLabels()

Method used for adding grouped labels when using LabelDisplayMode was GroupAllPoints.

Declaration

protected virtual void AddGroupLabels()

AddLabel(ChartPointInfo, ChartAlignment, ChartAlignment, DataTemplate)

Mathod implementation for adding labels in trackball.

Declaration

protected void AddLabel(ChartPointInfo obj, ChartAlignment verticalAlignment, ChartAlignment horizontalAlignment, DataTemplate template)

Parameters

Type	Name	Description
ChartPointInfo	obj	ChartPointInfo
ChartAlignment	verticalAlignment	Used to specify ChartAlignment for vertical
ChartAlignment	horizontalAlignment	Used to specify ChartAlignment for horizontal
Microsoft.UI.Xaml.DataTemplate	template	DataTemplate

AddLabel(Object, ChartAlignment, ChartAlignment, DataTemplate, Double, Double)

Method implementation for adding label in trackball.

Declaration

protected virtual void AddLabel(object obj, ChartAlignment verticalAlignment, ChartAlignment horizontalAlignment, DataTemplate labelTemplate, double x, double y)

Parameters

Type	Name	Description
System.Object	obj	ChartPointInfo
ChartAlignment	verticalAlignment	Used to specify ChartAlignment for vertical
ChartAlignment	horizontalAlignment	Used to specify ChartAlignment for horizontal
Microsoft.UI.Xaml.DataTemplate	labelTemplate	DataTemplate
System.Double	x	The X location
System.Double	y	The Y location

AddTrackball(ChartPointInfo)

Method implementation for adding trackball to corresponding chart point.

Declaration

protected virtual void AddTrackball(ChartPointInfo pointInfo)

Parameters

Type	Name	Description
ChartPointInfo	pointInfo	ChartPointInfo

AlignDefaultLabel(ChartAlignment, ChartAlignment, Double, Double, ContentControl)

Align the element inside the content control.

Declaration

protected override void AlignDefaultLabel(ChartAlignment verticalAlignemnt, ChartAlignment horizontalAlignment, double x, double y, ContentControl control)

Parameters

Type	Name	Description
ChartAlignment	verticalAlignemnt	Used to specify ChartAlignment for vertical
ChartAlignment	horizontalAlignment	Used to specify ChartAlignment for horizontal
System.Double	x	The X location
System.Double	y	The Y location
Microsoft.UI.Xaml.Controls.ContentControl	control	Used to specify corresponding content control

Overrides

ChartBehavior.AlignDefaultLabel(ChartAlignment, ChartAlignment, Double, Double, ContentControl)

AttachElements()

Method implementation for AttachElements.

Declaration

protected override void AttachElements()

Overrides

ChartBehavior.AttachElements()

ClearItems()

Method implementation for clear items in ChartTrackballbehavior.

Declaration

protected void ClearItems()

DetachElements()

Method implementation for DetachElements.

Declaration

protected override void DetachElements()

Overrides

ChartBehavior.DetachElements()

GenerateLabels()

Method implementation to generate the labels for trackball.

Declaration

protected virtual void GenerateLabels()

GenerateTrackballs()

Method implementation for generate Trackballs.

Declaration

protected virtual void GenerateTrackballs()

GetYValuesBasedOnValue(Double, ChartSeriesBase)

Return collection of double values from the given ChartSeries.

Declaration

protected IList<double> GetYValuesBasedOnValue(double x, ChartSeriesBase series)

Parameters

Type	Name	Description
System.Double	x	x position
ChartSeriesBase	series	chart series

Returns

Type	Description
System.Collections.Generic.IList<System.Double>

OnHolding(HoldingRoutedEventArgs)

Called when holding the focus in UIElement.

Declaration

protected override void OnHolding(HoldingRoutedEventArgs e)

Parameters

Type	Name	Description
Microsoft.UI.Xaml.Input.HoldingRoutedEventArgs	e	HoldingRoutedEventArgs

Overrides

ChartBehavior.OnHolding(HoldingRoutedEventArgs)

OnLayoutUpdated()

Called when layout updated in chart.

Declaration

protected override void OnLayoutUpdated()

Overrides

ChartBehavior.OnLayoutUpdated()

OnPointerExited(PointerRoutedEventArgs)

Called when pointer is exited.

Declaration

protected override void OnPointerExited(PointerRoutedEventArgs e)

Parameters

Type	Name	Description
Microsoft.UI.Xaml.Input.PointerRoutedEventArgs	e	PointerRoutedEventArgs

Overrides

ChartBehavior.OnPointerExited(PointerRoutedEventArgs)

OnPointerMoved(PointerRoutedEventArgs)

Called when pointer moved in the chart.

Declaration

protected override sealed void OnPointerMoved(PointerRoutedEventArgs e)

Parameters

Type	Name	Description
Microsoft.UI.Xaml.Input.PointerRoutedEventArgs	e	PointerRoutedEventArgs

Overrides

ChartBehavior.OnPointerMoved(PointerRoutedEventArgs)

OnPointerPositionChanged()

Called when pointer position changed in the chart.

Declaration

protected virtual void OnPointerPositionChanged()

OnPointerPositionChanged(Point)

Called when pointer position changed.

Declaration

protected virtual void OnPointerPositionChanged(Point point)

Parameters

Type	Name	Description
Windows.Foundation.Point	point	Point

OnPointerPressed(PointerRoutedEventArgs)

Called when pointer pressed in the chart.

Declaration

protected override void OnPointerPressed(PointerRoutedEventArgs e)

Parameters

Type	Name	Description
Microsoft.UI.Xaml.Input.PointerRoutedEventArgs	e	PointerRoutedEventArgs

Overrides

ChartBehavior.OnPointerPressed(PointerRoutedEventArgs)

OnPointerReleased(PointerRoutedEventArgs)

Called when pointer released in the chart.

Declaration

protected override void OnPointerReleased(PointerRoutedEventArgs e)

Parameters

Type	Name	Description
Microsoft.UI.Xaml.Input.PointerRoutedEventArgs	e	PointerRoutedEventArgs

Overrides

ChartBehavior.OnPointerReleased(PointerRoutedEventArgs)

OnSizeChanged(SizeChangedEventArgs)

Called when size changed.

Declaration

protected override void OnSizeChanged(SizeChangedEventArgs e)

Parameters

Type	Name	Description
Microsoft.UI.Xaml.SizeChangedEventArgs	e	SizeChangedEventArgs

Overrides

ChartBehavior.OnSizeChanged(SizeChangedEventArgs)

Events

PositionChanged

Event correspond to trackball position changed. It invokes after position changed to new mouse pointer position.

Declaration

public event EventHandler<PositionChangedEventArgs> PositionChanged

Event Type

Type	Description
System.EventHandler<PositionChangedEventArgs>

Remarks

PositionChangedEventArgs

PositionChanging

Event correspond to trackball position changing. It invokes before position changing from current position to new mouse position.

Declaration

public event EventHandler<PositionChangingEventArgs> PositionChanging

Event Type

Type	Description
System.EventHandler<PositionChangingEventArgs>

Remarks

PositionChangingEventArgs