Class SfCartesianChart

Renders different types of cartesian-type charts, each representing a unique style of representing data with a more user-friendly and greater UI visualization.

Inheritance

System.Object

ChartBase

SfCartesianChart

Implements

System.IDisposable

Inherited Members

ChartBase.LegendProperty

ChartBase.VisibleSeriesProperty

ChartBase.HeaderProperty

ChartBase.HorizontalHeaderAlignmentProperty

ChartBase.VerticalHeaderAlignmentProperty

ChartBase.TooltipBehaviorProperty

ChartBase.SuspendSeriesNotification()

ChartBase.ResumeSeriesNotification()

ChartBase.Dispose()

ChartBase.MeasureOverride(Size)

ChartBase.OnLostFocus(RoutedEventArgs)

ChartBase.OnGotFocus(RoutedEventArgs)

ChartBase.OnPointerCaptureLost(PointerRoutedEventArgs)

ChartBase.OnTapped(TappedRoutedEventArgs)

ChartBase.OnRightTapped(RightTappedRoutedEventArgs)

ChartBase.OnPointerWheelChanged(PointerRoutedEventArgs)

ChartBase.OnPointerExited(PointerRoutedEventArgs)

ChartBase.OnPointerEntered(PointerRoutedEventArgs)

ChartBase.OnPointerCanceled(PointerRoutedEventArgs)

ChartBase.OnKeyUp(KeyRoutedEventArgs)

ChartBase.OnKeyDown(KeyRoutedEventArgs)

ChartBase.OnHolding(HoldingRoutedEventArgs)

ChartBase.OnManipulationStarting(ManipulationStartingRoutedEventArgs)

ChartBase.OnManipulationStarted(ManipulationStartedRoutedEventArgs)

ChartBase.OnManipulationInertiaStarting(ManipulationInertiaStartingRoutedEventArgs)

ChartBase.OnManipulationCompleted(ManipulationCompletedRoutedEventArgs)

ChartBase.OnManipulationDelta(ManipulationDeltaRoutedEventArgs)

ChartBase.OnPointerPressed(PointerRoutedEventArgs)

ChartBase.OnPointerMoved(PointerRoutedEventArgs)

ChartBase.OnPointerReleased(PointerRoutedEventArgs)

ChartBase.OnDoubleTapped(DoubleTappedRoutedEventArgs)

ChartBase.Legend

ChartBase.TooltipBehavior

ChartBase.Header

ChartBase.HorizontalHeaderAlignment

ChartBase.VerticalHeaderAlignment

ChartBase.SeriesBoundsChanged

Namespace: Syncfusion.UI.Xaml.Charts

Assembly: Syncfusion.Chart.WinUI.dll

Syntax

public class SfCartesianChart : ChartBase, IDisposable

Remarks

The Cartesian chart control is used to visualize the data graphically, it typically have horizontal and vertical axes.

SfCartesianChart class properties provides an option to add the series and axis collection, allows to customize the chart elements such as series, axis, legend, data label and tooltip features.

Axis

ChartAxis is used to locate a data point inside the chart area. Charts typically have two axes that are used to measure and categorize data. Vertical(Y) axis always uses numerical scale. Horizontal(X) axis supports the Category, Numeric and Date time.

To render an axis, the chart axis instance has to be added in chart’s XAxes and YAxes collection as per the following code snippet.

MainPage.xaml
MainPage.xaml.cs

<chart:SfCartesianChart>

        <chart:SfCartesianChart.DataContext>
            <local:ViewModel/>
        </chart:SfCartesianChart.DataContext>

        <chart:SfCartesianChart.XAxes>
            <chart:NumericalAxis/>
        </chart:SfCartesianChart.XAxes>

        <chart:SfCartesianChart.YAxes>
            <chart:NumericalAxis/>
        </chart:SfCartesianChart.YAxes>

</chart:SfCartesianChart>

SfCartesianChart chart = new SfCartesianChart();

ViewModel viewModel = new ViewModel();
chart.DataContext = viewModel;

NumericalAxis xaxis = new NumericalAxis();
chart.XAxes.Add(xaxis);	

NumericalAxis yaxis = new NumericalAxis();
chart.YAxes.Add(yaxis);

Series

ChartSeries is the visual representation of data. SfCartesianChart offers many types such as Line, Fast line, Fast column, Fast scatter, Fast step line, Spline, Column, Scatter, Bubble, Area and SplineArea series. Based on your requirements and specifications, any type of series can be added for data visualization.

To render a series, create an instance of required series class, and add it to the Series collection.

 
<chart:SfCartesianChart>

       <chart:SfCartesianChart.DataContext>
           <local:ViewModel/>
       </chart:SfCartesianChart.DataContext>

       <chart:SfCartesianChart.XAxes>
           <chart:NumericalAxis/>
       </chart:SfCartesianChart.XAxes>

       <chart:SfCartesianChart.YAxes>
           <chart:NumericalAxis/>
       </chart:SfCartesianChart.YAxes>

       <chart:SfCartesianChart.Series>
           <chart:LineSeries ItemsSource = "{Binding Data}" XBindingPath="XValue" YBindingPath="YValue1"/>
           <chart:LineSeries ItemsSource = "{Binding Data}" XBindingPath="XValue" YBindingPath="YValue2"/>
       </chart:SfCartesianChart.Series>
</chart:SfCartesianChart>

SfCartesianChart chart = new SfCartesianChart();

ViewModel viewModel = new ViewModel();
chart.DataContext = viewModel;

NumericalAxis xaxis = new NumericalAxis();
chart.XAxes.Add(xaxis);	

NumericalAxis yaxis = new NumericalAxis();
chart.YAxes.Add(yaxis);

LineSeries series1 = new LineSeries()
{
    ItemsSource = viewmodel.Data,
    XBindingPath = "XValue",
    YBindingPath = "YValue1"
};
chart.Series.Add(series1);

LineSeries series2 = new LineSeries()
{
    ItemsSource = viewmodel.Data,
    XBindingPath = "XValue",
    YBindingPath = "YValue2"
};
chart.Series.Add(series2);

public ObservableCollection<Model> Data { get; set; }

public ViewModel()
{
   Data = new ObservableCollection<Model>();
   Data.Add(new Model() { XValue = 10, YValue1 = 100, YValue2 = 110 });
   Data.Add(new Model() { XValue = 20, YValue1 = 150, YValue2 = 100 });
   Data.Add(new Model() { XValue = 30, YValue1 = 110, YValue2 = 130 });
   Data.Add(new Model() { XValue = 40, YValue1 = 230, YValue2 = 180 });
}

Legend

The Legend contains list of chart series or data points in chart. The information provided in each legend item helps to identify the corresponding data series in chart. The Series Label property text will be displayed in the associated legend item.

To render a legend, create an instance of ChartLegend, and assign it to the Legend property.

MainPage.xaml
MainPage.xaml.cs

 
<chart:SfCartesianChart>

       <chart:SfCartesianChart.DataContext>
           <local:ViewModel/>
       </chart:SfCartesianChart.DataContext>

       <chart:SfCartesianChart.Legend>
           <chart:ChartLegend/>
       </chart:SfCartesianChart.Legend>

       <chart:SfCartesianChart.XAxes>
           <chart:NumericalAxis/>
       </chart:SfCartesianChart.XAxes>

       <chart:SfCartesianChart.YAxes>
           <chart:NumericalAxis/>
       </chart:SfCartesianChart.YAxes>

       <chart:SfCartesianChart.Series>
           <chart:LineSeries Label="Singapore" ItemsSource = "{Binding Data}" XBindingPath="XValue" YBindingPath="YValue1"/>
           <chart:LineSeries Label="Spain" ItemsSource = "{Binding Data}" XBindingPath="XValue" YBindingPath="YValue2"/>
       </chart:SfCartesianChart.Series>
</chart:SfCartesianChart>

SfCartesianChart chart = new SfCartesianChart();

ViewModel viewModel = new ViewModel();
chart.DataContext = viewModel;

chart.Legend = new ChartLegend();

NumericalAxis xaxis = new NumericalAxis();
chart.XAxes.Add(xaxis);	

NumericalAxis yaxis = new NumericalAxis();
chart.YAxes.Add(yaxis);

LineSeries series1 = new LineSeries()
{
    ItemsSource = viewmodel.Data,
    XBindingPath = "XValue",
    YBindingPath = "YValue1",
    Label = "Singapore"
};
chart.Series.Add(series1);

LineSeries series2 = new LineSeries()
{
    ItemsSource = viewmodel.Data,
    XBindingPath = "XValue",
    YBindingPath = "YValue2",
    Label = "Spain"
};
chart.Series.Add(series2);

Tooltip

Tooltip displays information while tapping or mouse hover on the segment. To display the tooltip on chart, you need to set the EnableTooltip property as true in ChartSeries.

To customize the appearance of the tooltip elements like Background, TextColor and Font, create an instance of ChartTooltipBehavior class, modify the values, and assign it to the chart’s TooltipBehavior property.

MainPage.xaml
MainPage.xaml.cs

<chart:SfCartesianChart>

        <chart:SfCartesianChart.DataContext>
            <local:ViewModel/>
        </chart:SfCartesianChart.DataContext>

        <chart:SfCartesianChart.TooltipBehavior>
            <chart:ChartTooltipBehavior/>
        </chart:SfCartesianChart.TooltipBehavior>

        <chart:SfCartesianChart.XAxes>
            <chart:NumericalAxis/>
        </chart:SfCartesianChart.XAxes>

        <chart:SfCartesianChart.YAxes>
            <chart:NumericalAxis/>
        </chart:SfCartesianChart.YAxes>

        <chart:SfCartesianChart.Series>
            <chart:LineSeries EnableTooltip="True"
                              ItemsSource="{Binding Data}"
                              XBindingPath="XValue"
                              YBindingPath="YValue1"/>
            <chart:LineSeries EnableTooltip="True"
                              ItemsSource="{Binding Data}"
                              XBindingPath="XValue"
                              YBindingPath="YValue2"/>
        </chart:SfCartesianChart.Series>

</chart:SfCartesianChart>

SfCartesianChart chart = new SfCartesianChart();

ViewModel viewModel = new ViewModel();
chart.DataContext = viewModel;

chart.TooltipBehavior = new ChartTooltipBehavior();

NumericalAxis xaxis = new NumericalAxis();
chart.XAxes.Add(xaxis);	

NumericalAxis yaxis = new NumericalAxis();
chart.YAxes.Add(yaxis);

LineSeries series1 = new LineSeries()
{
   ItemsSource = viewmodel.Data,
   XBindingPath = "XValue",
   YBindingPath = "YValue1",
   EnableTooltip = true
};
chart.Series.Add(series1);

LineSeries series2 = new LineSeries()
{
   ItemsSource = viewmodel.Data,
   XBindingPath = "XValue",
   YBindingPath = "YValue2",
   EnableTooltip = true
};
chart.Series.Add(series2);

Data Label

Data labels are used to display values related to a chart segment. To render the data labels, you need to enable the ShowDataLabels property as true in DataMarkerSeries class.

To customize the chart data labels alignment, placement and label styles, need to create an instance of CartesianDataLabelSettings and set to the DataLabelSettings property.

MainPage.xaml
MainPage.xaml.cs

<chart:SfCartesianChart>

       <chart:SfCartesianChart.DataContext>
           <local:ViewModel/>
       </chart:SfCartesianChart.DataContext>

       <chart:SfCartesianChart.XAxes>
           <chart:NumericalAxis/>
       </chart:SfCartesianChart.XAxes>

       <chart:SfCartesianChart.YAxes>
           <chart:NumericalAxis/>
       </chart:SfCartesianChart.YAxes>

       <chart:SfCartesianChart.Series>
           <chart:ColumnSeries ShowDataLabels="True"
                               ItemsSource="{Binding Data}"
                               XBindingPath="XValue"
                               YBindingPath="YValue1"/>
       </chart:SfCartesianChart.Series>
</chart:SfCartesianChart>

SfCartesianChart chart = new SfCartesianChart();

ViewModel viewModel = new ViewModel();
chart.DataContext = viewModel;

NumericalAxis xaxis = new NumericalAxis();
chart.XAxes.Add(xaxis);	

NumericalAxis yaxis = new NumericalAxis();
chart.YAxes.Add(yaxis);

ColumnSeries series = new ColumnSeries()
{
    ItemsSource = viewmodel.Data,
    XBindingPath = "XValue",
    YBindingPath = "YValue1",
    ShowDataLabels = true
};
chart.Series.Add(series);

Zooming and Panning

SfCartesianChart allows you to zoom the chart area with the help of the zoom feature. This behavior is mostly used to view the data point in the specific area, when there are large number of data points inside the chart.

Zooming and panning provides you to take a close-up look of the data point plotted in the series. To enable the zooming and panning in the chart, create an instance of ChartZoomPanBehavior and set it to the ZoomPanBehavior property of SfCartesianChart.

MainPage.xaml
MainPage.xaml.cs

<chart:SfCartesianChart>

       <chart:SfCartesianChart.DataContext>
           <local:ViewModel/>
       </chart:SfCartesianChart.DataContext>

       <chart:SfCartesianChart.ZoomPanBehavior>
           <chart:ChartZoomPanBehavior EnablePanning = "True" EnableDoubleTap="True" EnablePinchZooming="True"/>
       </chart:SfCartesianChart.ZoomPanBehavior>

       <chart:SfCartesianChart.XAxes>
           <chart:NumericalAxis/>
       </chart:SfCartesianChart.XAxes>

       <chart:SfCartesianChart.YAxes>
           <chart:NumericalAxis/>
       </chart:SfCartesianChart.YAxes>

       <chart:SfCartesianChart.Series>
            <chart:LineSeries ItemsSource="{Binding Data}"
                              XBindingPath="XValue"
                              YBindingPath="YValue1"/>
            <chart:LineSeries ItemsSource="{Binding Data}"
                              XBindingPath="XValue"
                              YBindingPath="YValue2"/>
        </chart:SfCartesianChart.Series>
</chart:SfCartesianChart>

SfCartesianChart chart = new SfCartesianChart();

ViewModel viewModel = new ViewModel();
chart.DataContext = viewModel;

chart.ZoomPanBehavior = new ChartZoomPanBehavior() { EnablePinchZooming = true, EnableDoubleTap = true, EnablePanning = true };

NumericalAxis xaxis = new NumericalAxis();
chart.XAxes.Add(xaxis);	

NumericalAxis yaxis = new NumericalAxis();
chart.YAxes.Add(yaxis);

LineSeries series1 = new LineSeries()
{
   ItemsSource = viewmodel.Data,
   XBindingPath = "XValue",
   YBindingPath = "YValue1",
};
chart.Series.Add(series1);

LineSeries series2 = new LineSeries()
{
   ItemsSource = viewmodel.Data,
   XBindingPath = "XValue",
   YBindingPath = "YValue2",
};
chart.Series.Add(series2);

Selection

SfCartesianChart allows you to select or highlight a segment or series in the chart by using ChartSelectionBehavior.

SfCartessianChart provides seperate behaviors for series and segment selection. To enable the series selection in the chart, create an instance of SeriesSelectionBehavior and set it to the SelectionBehavior property of SfCartesianChart.

MainPage.xaml
MainPage.xaml.cs

<chart:SfCartesianChart>

       <chart:SfCartesianChart.DataContext>
           <local:ViewModel/>
       </chart:SfCartesianChart.DataContext>

       <chart:SfCartesianChart.SelectionBehavior>
           <chart:SeriesSelectionBehavior SelectionBrush="Red"/>
       </chart:SfCartesianChart.SelectionBehavior>

       <chart:SfCartesianChart.XAxes>
           <chart:NumericalAxis/>
       </chart:SfCartesianChart.XAxes>

       <chart:SfCartesianChart.YAxes>
           <chart:NumericalAxis/>
       </chart:SfCartesianChart.YAxes>

       <chart:SfCartesianChart.Series>
            <chart:ColumnSeries ItemsSource="{Binding Data}"
                                XBindingPath="XValue"
                                YBindingPath="YValue1"/>
            <chart:ColumnSeries ItemsSource="{Binding Data}"
                                XBindingPath="XValue"
                                YBindingPath="YValue2"/>
        </chart:SfCartesianChart.Series>
</chart:SfCartesianChart>

SfCartesianChart chart = new SfCartesianChart();

ViewModel viewModel = new ViewModel();
chart.DataContext = viewModel;

chart.SelectionBehavior = new SeriesSelectionBehavior() { SelectionBrush=new SolidColorBrush(Colors.Green) };

NumericalAxis xaxis = new NumericalAxis();
chart.XAxes.Add(xaxis);	

NumericalAxis yaxis = new NumericalAxis();
chart.YAxes.Add(yaxis);

ColumnSeries series1 = new ColumnSeries()
{
   ItemsSource = viewmodel.Data,
   XBindingPath = "XValue",
   YBindingPath = "YValue1",
};
chart.Series.Add(series1);

ColumnSeries series2 = new ColumnSeries()
{
   ItemsSource = viewmodel.Data,
   XBindingPath = "XValue",
   YBindingPath = "YValue2",
};
chart.Series.Add(series2);

DataPointSelectionBehavior is applicable only to certain series such as ColumnSeries, AreaSeries, BubbleSeries, LineSeries, ScatterSeries, SplineSeries, SplineAreaSeries, StackedAreaSeries, StackedColumnSeries, StepAreaSeries, StepLineSeries.

To enable the segment selection in the chart, create an instance of DataPointSelectionBehavior and set it to the SelectionBehavior property of series.

MainPage.xaml
MainPage.xaml.cs

<chart:SfCartesianChart>

       <chart:SfCartesianChart.DataContext>
           <local:ViewModel/>
       </chart:SfCartesianChart.DataContext>

       <chart:SfCartesianChart.XAxes>
           <chart:NumericalAxis/>
       </chart:SfCartesianChart.XAxes>

       <chart:SfCartesianChart.YAxes>
           <chart:NumericalAxis/>
       </chart:SfCartesianChart.YAxes>

        <chart:SfCartesianChart.Series>
            <chart:ColumnSeries ItemsSource = "{Binding Data}" XBindingPath="XValue" YBindingPath="YValue1">
                <chart:ColumnSeries.SelectionBehavior>
                    <chart:DataPointSelectionBehavior SelectionBrush = "Green" />
                </chart:ColumnSeries.SelectionBehavior>
            </chart:ColumnSeries>
        </chart:SfCartesianChart.Series>
</chart:SfCartesianChart>

SfCartesianChart chart = new SfCartesianChart();

ViewModel viewModel = new ViewModel();
chart.DataContext = viewModel;

NumericalAxis xaxis = new NumericalAxis();
chart.XAxes.Add(xaxis);	

NumericalAxis yaxis = new NumericalAxis();
chart.YAxes.Add(yaxis);

DataPointSelectionBehavior selectionBehavior = new DataPointSelectionBehavior()
{
   SelectionBrush=new SolidColorBrush(Colors.Green)
};
ColumnSeries series1 = new ColumnSeries()
{
   ItemsSource = viewmodel.Data,
   XBindingPath = "XValue",
   YBindingPath = "YValue1",
   Selection = selectionBehavior
};
chart.Series.Add(series1);

Cross Hair

SfCartesianChart allows you to view the informations related to chart coordinates, at mouse over position or at touch contact point inside a chart.

ChartCrosshairBehavior displays a vertical line, horizontal line and a popup like control displaying information about the data point at touch contact point or at mouse over position. To enable the crosshair in the chart, create an instance of ChartCrosshairBehavior and set it to the CrosshairBehavior property of SfCartesianChart.

MainPage.xaml
MainPage.xaml.cs

<chart:SfCartesianChart>

       <chart:SfCartesianChart.DataContext>
           <local:ViewModel/>
       </chart:SfCartesianChart.DataContext>

       <chart:SfCartesianChart.CrosshairBehavior>
           <chart:ChartCrosshairBehavior/>
       </chart:SfCartesianChart.CrosshairBehavior>

       <chart:SfCartesianChart.XAxes>
           <chart:NumericalAxis/>
       </chart:SfCartesianChart.XAxes>

       <chart:SfCartesianChart.YAxes>
           <chart:NumericalAxis/>
       </chart:SfCartesianChart.YAxes>

       <chart:SfCartesianChart.Series>
            <chart:LineSeries ItemsSource="{Binding Data}"
                              XBindingPath="XValue"
                              YBindingPath="YValue1"/>
            <chart:LineSeries ItemsSource="{Binding Data}"
                              XBindingPath="XValue"
                              YBindingPath="YValue2"/>
        </chart:SfCartesianChart.Series>
</chart:SfCartesianChart>

SfCartesianChart chart = new SfCartesianChart();

ViewModel viewModel = new ViewModel();
chart.DataContext = viewModel;

chart.CrosshairBehavior = new ChartCrosshairBehavior();

NumericalAxis xaxis = new NumericalAxis();
chart.XAxes.Add(xaxis);	

NumericalAxis yaxis = new NumericalAxis();
chart.YAxes.Add(yaxis);

LineSeries series1 = new LineSeries()
{
   ItemsSource = viewmodel.Data,
   XBindingPath = "XValue",
   YBindingPath = "YValue1",
};
chart.Series.Add(series1);

LineSeries series2 = new LineSeries()
{
   ItemsSource = viewmodel.Data,
   XBindingPath = "XValue",
   YBindingPath = "YValue2",
};
chart.Series.Add(series2);

Track Ball

SfCartesianChart allows you to view tooltip for the data points that are nearer to mouse over position or at touch contact point in a Chart.

To enable the track ball in the chart, create an instance of ChartTrackballBehavior and set it to the TrackballBehavior property of SfCartesianChart.

To view the trackball label in the particular axis, you have to enable the ShowTrackballInfo property in that axis.

MainPage.xaml
MainPage.xaml.cs

<chart:SfCartesianChart>

       <chart:SfCartesianChart.DataContext>
           <local:ViewModel/>
       </chart:SfCartesianChart.DataContext>

       <chart:SfCartesianChart.TrackballBehavior>
           <chart:ChartTrackballBehavior/>
       </chart:SfCartesianChart.TrackballBehavior>

       <chart:SfCartesianChart.XAxes>
           <chart:NumericalAxis ShowTrackballInfo="true"/>
       </chart:SfCartesianChart.XAxes>

       <chart:SfCartesianChart.YAxes>
           <chart:NumericalAxis/>
       </chart:SfCartesianChart.YAxes>

       <chart:SfCartesianChart.Series>
            <chart:LineSeries ItemsSource="{Binding Data}"
                              XBindingPath="XValue"
                              YBindingPath="YValue1"/>
            <chart:LineSeries ItemsSource="{Binding Data}"
                              XBindingPath="XValue"
                              YBindingPath="YValue2"/>
        </chart:SfCartesianChart.Series>
</chart:SfCartesianChart>

SfCartesianChart chart = new SfCartesianChart();

ViewModel viewModel = new ViewModel();
chart.DataContext = viewModel;

chart.TrackballBehavior = new ChartTrackballBehavior();

NumericalAxis xaxis = new NumericalAxis();
xaxis.ShowTrackballInfo = true;
chart.XAxes.Add(xaxis);	

NumericalAxis yaxis = new NumericalAxis();
chart.YAxes.Add(yaxis);

LineSeries series1 = new LineSeries()
{
   ItemsSource = viewmodel.Data,
   XBindingPath = "XValue",
   YBindingPath = "YValue1",
};
chart.Series.Add(series1);

LineSeries series2 = new LineSeries()
{
   ItemsSource = viewmodel.Data,
   XBindingPath = "XValue",
   YBindingPath = "YValue2",
};
chart.Series.Add(series2);

Constructors

SfCartesianChart()

Initializes a new instance of the SfCartesianChart class.

Declaration

public SfCartesianChart()

Fields

CrosshairBehaviorProperty

The DependencyProperty for CrosshairBehavior property.

Declaration

public static readonly DependencyProperty CrosshairBehaviorProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty

EnableSideBySideSeriesPlacementProperty

Identifies the EnableSideBySideSeriesPlacement dependency property.

Declaration

public static readonly DependencyProperty EnableSideBySideSeriesPlacementProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty	The identifier for `EnableSideBySideSeriesPlacement` dependency property.

IsTransposedProperty

The DependencyProperty for IsTransposed property.

Declaration

public static readonly DependencyProperty IsTransposedProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty

PaletteBrushesProperty

Identifies the PaletteBrushes dependency property.

Declaration

public static readonly DependencyProperty PaletteBrushesProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty	The identifier for `PaletteBrushes` dependency property.

PlotAreaBackgroundProperty

Identifies the PlotAreaBackground dependency property.

Declaration

public static readonly DependencyProperty PlotAreaBackgroundProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty	The identifier for `PlotAreaBackground` dependency property.

PlotAreaBorderBrushProperty

Identifies the PlotAreaBorderBrush dependency property.

Declaration

public static readonly DependencyProperty PlotAreaBorderBrushProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty	The identifier for `PlotAreaBorderBrush` dependency property.

PlotAreaBorderThicknessProperty

Identifies the PlotAreaBorderThickness dependency property.

Declaration

public static readonly DependencyProperty PlotAreaBorderThicknessProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty	The identifier for `PlotAreaBorderThickness` dependency property.

SelectionBehaviorProperty

The DependencyProperty for SelectionBehavior property.

Declaration

public static readonly DependencyProperty SelectionBehaviorProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty

SeriesProperty

Identifies the Series dependency property.

Declaration

public static readonly DependencyProperty SeriesProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty	The identifier for `Series` dependency property.

TrackballBehaviorProperty

The DependencyProperty for TrackballBehavior property.

Declaration

public static readonly DependencyProperty TrackballBehaviorProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty

ZoomPanBehaviorProperty

The DependencyProperty for ZoomPanBehavior property.

Declaration

public static readonly DependencyProperty ZoomPanBehaviorProperty

Field Value

Type	Description
Microsoft.UI.Xaml.DependencyProperty

Properties

CrosshairBehavior

Gets or sets a value that allows the crosshair to display the cursor position in the chart.

Declaration

public ChartCrosshairBehavior CrosshairBehavior { get; set; }

Property Value

Type	Description
ChartCrosshairBehavior	This property takes the ChartCrosshairBehavior value and its default value is null.

    <chart:SfCartesianChart>

          <chart:SfCartesianChart.DataContext>
              <local:ViewModel/>
          </chart:SfCartesianChart.DataContext>

          <chart:SfCartesianChart.CrosshairBehavior>
              <chart:ChartCrosshairBehavior />
          </chart:SfCartesianChart.CrosshairBehavior>

          <chart:SfCartesianChart.XAxes>
              <chart:NumericalAxis/>
          </chart:SfCartesianChart.XAxes>

          <chart:SfCartesianChart.YAxes>
              <chart:NumericalAxis/>
          </chart:SfCartesianChart.YAxes>

          <chart:LineSeries ItemsSource="{Binding Data}"
                            XBindingPath="XValue"
                            YBindingPath="YValue1"/>

    </chart:SfCartesianChart>

    SfCartesianChart chart = new SfCartesianChart();

    ViewModel viewModel = new ViewModel();
    chart.DataContext = viewModel;

    chart.CrosshairBehavior = new ChartCrosshairBehavior();

    NumericalAxis xaxis = new NumericalAxis();
    chart.XAxes.Add(xaxis);

    NumericalAxis yaxis = new NumericalAxis();
    chart.YAxes.Add(yaxis);

    LineSeries series = new LineSeries()
    {
       ItemsSource = viewModel.Data,
       XBindingPath = "XValue",
       YBindingPath = "YValue1",
    };
    chart.Series.Add(series);

EnableSideBySideSeriesPlacement

Gets or sets a System.Boolean value that indicates whether the series are placed side by side or overlapped.

Declaration

public bool EnableSideBySideSeriesPlacement { get; set; }

Property Value

Type	Description
System.Boolean	This proeprty takes the boolean value and its default value is `true`.

Remarks

If the value is true, series placed side by side, else series rendered one over other(overlapped).

IsTransposed

Gets or sets a System.Boolean value that indicates whether to change the cartesian chart orientation.

Declaration

public bool IsTransposed { get; set; }

Property Value

Type	Description
System.Boolean	This proeprty takes the boolean value and its default value is `false`.

Remarks

If the value is true, the orientation of x-axis is set to vertical and orientation of y-axis is set to horizontal.

PaletteBrushes

Gets or sets the palette brushes for chart.

Declaration

public IList<Brush> PaletteBrushes { get; set; }

Property Value

Type	Description
System.Collections.Generic.IList<Microsoft.UI.Xaml.Media.Brush>	This property takes the list of Microsoft.UI.Xaml.Media.Brush and its default value is predefined palette.

PlotAreaBackground

Gets or sets the brush value to customize the background appearance of the chart area.

Declaration

public Brush PlotAreaBackground { get; set; }

Property Value

Type	Description
Microsoft.UI.Xaml.Media.Brush	It accepts Microsoft.UI.Xaml.Media.Brush value.

PlotAreaBorderBrush

Gets or sets the brush value to customize the outline appearance of the chart area.

Declaration

public Brush PlotAreaBorderBrush { get; set; }

Property Value

Type	Description
Microsoft.UI.Xaml.Media.Brush	It accepts Microsoft.UI.Xaml.Media.Brush value.

PlotAreaBorderThickness

Gets or sets the value to customize the outline thickness of chart area.

Declaration

public Thickness PlotAreaBorderThickness { get; set; }

Property Value

Type	Description
Microsoft.UI.Xaml.Thickness	It accepts Microsoft.UI.Xaml.Thickness value.

SelectionBehavior

Gets or sets a value for initiating selection or highlighting of a single or multiple series in the chart.

Declaration

public SeriesSelectionBehavior SelectionBehavior { get; set; }

Property Value

Type	Description
SeriesSelectionBehavior	This property takes a SeriesSelectionBehavior instance as a value, and its default value is null.

Examples

MainPage.xaml
MainPage.xaml.cs

<chart:SfCartesianChart>
        <chart:SfCartesianChart.XAxes>
            <chart:DateTimeAxis/>
        </chart:SfCartesianChart.XAxes>
        <chart:SfCartesianChart.YAxes>
            <chart:NumericalAxis/>
        </chart:SfCartesianChart.YAxes>
        <chart:SfCartesianChart.SelectionBehavior>
            <chart:SeriesSelectionBehavior/>
        </chart:SfCartesianChart.SelectionBehavior>
        <chart:ColumnSeries ItemsSource="{Binding Data}"
                            XBindingPath="Date"
                            YBindingPath="High"/>
        <chart:ColumnSeries ItemsSource="{Binding Data}"
                            XBindingPath="Date"
                            YBindingPath="Low"/>
</chart:SfCircularChart>

 SfCartesianChart chart = new SfCartesianChart();

 ViewModel viewModel = new ViewModel();
 chart.DataContext = viewModel;

 chart.XAxes.Add(new DateTimeAxis())
 chart.YAxes.Add(new NumericalAxis())

 chart.SelectionBehavior = new SeriesSelectionBehavior() {SelectionBrush = Colors.Blue};

 ColumnSeries series = new ColumnSeries()
 {
    ItemsSource = viewmodel.Data,
    XBindingPath = "Date",
    YBindingPath = "High"
 };

ColumnSeries series2 = new ColumnSeries()
 {
    ItemsSource = viewmodel.Data,
    XBindingPath = "Date",
    YBindingPath = "Low"
 };

 chart.Series.Add(series);
 chart.Series.Add(series2);

Series

Gets or sets a collection of chart series to be added to the cartesian chart.

Declaration

public CartesianSeriesCollection Series { get; set; }

Property Value

Type	Description
CartesianSeriesCollection	This property takes CartesianSeriesCollection instance as value.

Remarks

To render a series, create an instance of required series class, and add it to the Series collection.

Examples

    <chart:SfCartesianChart>

       <chart:SfCartesianChart.DataContext>
           <local:ViewModel/>
       </chart:SfCartesianChart.DataContext>

       <chart:SfCartesianChart.XAxes>
           <chart:NumericalAxis/>
       </chart:SfCartesianChart.XAxes>

       <chart:SfCartesianChart.YAxes>
           <chart:NumericalAxis/>
       </chart:SfCartesianChart.YAxes>

       <chart:LineSeries ItemsSource="{Binding Data}"
                         XBindingPath="XValue"
                         YBindingPath="YValue1"/>
       <chart:LineSeries ItemsSource="{Binding Data}"
                         XBindingPath="XValue"
                         YBindingPath="YValue2"/>

    </chart:SfCartesianChart>

    SfCartesianChart chart = new SfCartesianChart();

    ViewModel viewModel = new ViewModel();
    chart.DataContext = viewModel;

    NumericalAxis xaxis = new NumericalAxis();
    chart.XAxes.Add(xaxis);

    NumericalAxis yaxis = new NumericalAxis();
    chart.YAxes.Add(yaxis);

    LineSeries series1 = new LineSeries()
    {
        ItemsSource = viewModel.Data,
        XBindingPath = "XValue",
        YBindingPath = "YValue1"
    };
    chart.Series.Add(series1);

    LineSeries series2 = new LineSeries()
    {
        ItemsSource = viewModel.Data,
        XBindingPath = "XValue",
        YBindingPath = "YValue2"
    };
    chart.Series.Add(series2);

public ObservableCollection<Model> Data { get; set; }

public ViewModel()
{
   Data = new ObservableCollection<Model>();
   Data.Add(new Model() { XValue = 10, YValue1 = 100, YValue2 = 110 });
   Data.Add(new Model() { XValue = 20, YValue1 = 150, YValue2 = 100 });
   Data.Add(new Model() { XValue = 30, YValue1 = 110, YValue2 = 130 });
   Data.Add(new Model() { XValue = 40, YValue1 = 230, YValue2 = 180 });
}

TrackballBehavior

Gets or sets a value that allows tracking a data point closer to the cursor position in the chart.

Declaration

public ChartTrackballBehavior TrackballBehavior { get; set; }

Property Value

Type	Description
ChartTrackballBehavior	This property takes the ChartTrackballBehavior value and its default value is null.

Examples

MainPage.xaml
MainPage.xaml.cs

    <chart:SfCartesianChart>

          <chart:SfCartesianChart.DataContext>
              <local:ViewModel/>
          </chart:SfCartesianChart.DataContext>

          <chart:SfCartesianChart.TrackballBehavior>
              <chart:ChartTrackballBehavior ShowLine="True" LabelDisplayMode="GroupAllPoints"/>
          </chart:SfCartesianChart.TrackballBehavior>

          <chart:SfCartesianChart.XAxes>
              <chart:NumericalAxis/>
          </chart:SfCartesianChart.XAxes>

          <chart:SfCartesianChart.YAxes>
              <chart:NumericalAxis/>
          </chart:SfCartesianChart.YAxes>

          <chart:LineSeries ItemsSource="{Binding Data}"
                            XBindingPath="XValue"
                            YBindingPath="YValue1"/>

    </chart:SfCartesianChart>

    SfCartesianChart chart = new SfCartesianChart();

    ViewModel viewModel = new ViewModel();
    chart.DataContext = viewModel;

    chart.TrackballBehavior = new ChartTrackballBehavior() { LabelDisplayMode = TrackballLabelDisplayMode.GroupAllPoints, ShowLine = true };

    NumericalAxis xaxis = new NumericalAxis();
    chart.XAxes.Add(xaxis);

    NumericalAxis yaxis = new NumericalAxis();
    chart.YAxes.Add(yaxis);

    LineSeries series = new LineSeries()
    {
       ItemsSource = viewModel.Data,
       XBindingPath = "XValue",
       YBindingPath = "YValue1",
    };
    chart.Series.Add(series);

XAxes

Gets the collection of horizontal axes in the chart.

Declaration

public ObservableCollection<ChartAxis> XAxes { get; }

Property Value

Type	Description
System.Collections.ObjectModel.ObservableCollection<ChartAxis>	Returns the collection of ChartAxis.

Remarks

Horizontal(X) axis supports the Category, Numeric and Date time.

Examples

MainPage.xaml
MainPage.xaml.cs

<chart:SfCartesianChart>

        <chart:SfCartesianChart.DataContext>
            <local:ViewModel/>
        </chart:SfCartesianChart.DataContext>

        <chart:SfCartesianChart.XAxes>
            <chart:NumericalAxis/>
        </chart:SfCartesianChart.XAxes>

</chart:SfCartesianChart>

SfCartesianChart chart = new SfCartesianChart();

ViewModel viewModel = new ViewModel();
chart.DataContext = viewModel;

NumericalAxis xaxis = new NumericalAxis();
chart.XAxes.Add(xaxis);

YAxes

Gets the collection of vertical axes in the chart.

Declaration

public ObservableCollection<RangeAxisBase> YAxes { get; }

Property Value

Type	Description
System.Collections.ObjectModel.ObservableCollection<RangeAxisBase>	Returns the collection of RangeAxisBase.

Remarks

Vertical(Y) axis always uses numerical scale.

Examples

MainPage.xaml
MainPage.xaml.cs

<chart:SfCartesianChart>

        <chart:SfCartesianChart.DataContext>
            <local:ViewModel/>
        </chart:SfCartesianChart.DataContext>

        <chart:SfCartesianChart.YAxes>
            <chart:NumericalAxis/>
        </chart:SfCartesianChart.YAxes>

</chart:SfCartesianChart>

SfCartesianChart chart = new SfCartesianChart();

ViewModel viewModel = new ViewModel();
chart.DataContext = viewModel;

NumericalAxis yaxis = new NumericalAxis();
chart.YAxes.Add(yaxis);

ZoomPanBehavior

Gets or sets a value for initiating the zooming and panning operations in chart.

Declaration

public ChartZoomPanBehavior ZoomPanBehavior { get; set; }

Property Value

Type	Description
ChartZoomPanBehavior	This property takes the ChartZoomPanBehavior value and its default value is null.

Examples

MainPage.xaml
MainPage.xaml.cs

    <chart:SfCartesianChart>

          <chart:SfCartesianChart.DataContext>
              <local:ViewModel/>
          </chart:SfCartesianChart.DataContext>

          <chart:SfCartesianChart.ZoomPanBehavior>
              <chart:ChartZoomPanBehavior EnablePinchZooming="True" EnablePanning="True"/>
          </chart:SfCartesianChart.ZoomPanBehavior>

          <chart:SfCartesianChart.XAxes>
              <chart:NumericalAxis/>
          </chart:SfCartesianChart.XAxes>

          <chart:SfCartesianChart.YAxes>
              <chart:NumericalAxis/>
          </chart:SfCartesianChart.YAxes>

          <chart:LineSeries ItemsSource="{Binding Data}"
                            XBindingPath="XValue"
                            YBindingPath="YValue1"/>

    </chart:SfCartesianChart>

    SfCartesianChart chart = new SfCartesianChart();

    ViewModel viewModel = new ViewModel();
    chart.DataContext = viewModel;

    chart.ZoomPanBehavior = new ChartZoomPanBehavior() { EnablePinchZooming = true, EnablePanning = true };

    NumericalAxis xaxis = new NumericalAxis();
    chart.XAxes.Add(xaxis);

    NumericalAxis yaxis = new NumericalAxis();
    chart.YAxes.Add(yaxis);

    LineSeries series = new LineSeries()
    {
       ItemsSource = viewModel.Data,
       XBindingPath = "XValue",
       YBindingPath = "YValue1",
    };
    chart.Series.Add(series);

Methods

OnApplyTemplate()

Declaration

protected override void OnApplyTemplate()

Overrides

ChartBase.OnApplyTemplate()

Implements

System.IDisposable

WinUI- v20.4.0.38

Class SfCartesianChart

Inheritance

Implements

Inherited Members

Namespace: Syncfusion.UI.Xaml.Charts

Assembly: Syncfusion.Chart.WinUI.dll

Syntax

Remarks

Constructors

SfCartesianChart()

Declaration

Fields

CrosshairBehaviorProperty

Declaration

Field Value

EnableSideBySideSeriesPlacementProperty

Declaration

Field Value

IsTransposedProperty

Declaration

Field Value

PaletteBrushesProperty

Declaration

Field Value

PlotAreaBackgroundProperty

Declaration

Field Value

PlotAreaBorderBrushProperty

Declaration

Field Value

PlotAreaBorderThicknessProperty

Declaration

Field Value

SelectionBehaviorProperty

Declaration

Field Value

SeriesProperty

Declaration

Field Value

TrackballBehaviorProperty

Declaration

Field Value

ZoomPanBehaviorProperty

Declaration

Field Value

Properties

CrosshairBehavior

Declaration

Property Value

Examples

EnableSideBySideSeriesPlacement

Declaration

Property Value

Remarks

IsTransposed

Declaration

Property Value

Remarks

PaletteBrushes

Declaration

Property Value

PlotAreaBackground

Declaration

Property Value

PlotAreaBorderBrush

Declaration

Property Value

PlotAreaBorderThickness

Declaration

Property Value

SelectionBehavior

Declaration

Property Value

Examples

Series

Declaration

Property Value

Remarks

Examples