Class SfCartesianChart

Represents the cartesian chart control which is used to visualize the data graphically. The chart is often used to make it easier to understand large amount of data and the relationship between different parts of the data.

Inheritance

System.Object

ChartBase

SfCartesianChart

Implements

System.IDisposable

Inherited Members

ChartBase.VisibleSeriesProperty

ChartBase.PaletteProperty

ChartBase.HeaderProperty

ChartBase.HorizontalHeaderAlignmentProperty

ChartBase.VerticalHeaderAlignmentProperty

ChartBase.ColorModelProperty

ChartBase.LegendProperty

ChartBase.SuspendSeriesNotification()

ChartBase.ResumeSeriesNotification()

ChartBase.Dispose()

ChartBase.Dispose(Boolean)

ChartBase.OnApplyTemplate()

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.OnDrop(DragEventArgs)

ChartBase.OnDragOver(DragEventArgs)

ChartBase.OnDragLeave(DragEventArgs)

ChartBase.OnDragEnter(DragEventArgs)

ChartBase.Behaviors

ChartBase.SeriesClipRect

ChartBase.VisibleSeries

ChartBase.Palette

ChartBase.SelectedSeriesIndex

ChartBase.Header

ChartBase.HorizontalHeaderAlignment

ChartBase.VerticalHeaderAlignment

ChartBase.ColorModel

ChartBase.Legend

ChartBase.SelectionChanged

ChartBase.SelectionChanging

ChartBase.SeriesBoundsChanged

Namespace: Syncfusion.UI.Xaml.Charts

Assembly: Syncfusion.Chart.WinUI.dll

Syntax

public class SfCartesianChart : ChartBase, IDisposable

Examples

• MainWindow.xaml
• MainWindow.cs
• ViewModel.cs

    <chart:SfCartesianChart>

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

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

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

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

    </chart:SfCartesianChart>

Constructors

SfCartesianChart()

Initializes a new instance of the SfCartesianChart class.

Declaration

public SfCartesianChart()

Fields

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.

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.

PrimaryAxisProperty

Identifies the PrimaryAxis dependency property.

Declaration

public static readonly DependencyProperty PrimaryAxisProperty

Field Value

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

SecondaryAxisProperty

Identifies the SecondaryAxis dependency property.

Declaration

public static readonly DependencyProperty SecondaryAxisProperty

Field Value

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

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.

Properties

Axes

Gets the collection of horizontal and vertical axis.

Declaration

public ChartAxisCollection Axes { get; }

Property Value

Type	Description
ChartAxisCollection	It takes the ChartAxisCollection value.

EnableSideBySideSeriesPlacement

Gets or sets the value that indicates whether the series can be placed side by side.

Declaration

public bool EnableSideBySideSeriesPlacement { get; set; }

Property Value

Type	Description
System.Boolean	It takes the bool value and its default value is true.

PlotAreaBackground

Gets or sets the background color of the plotting area.

Declaration

public Brush PlotAreaBackground { get; set; }

Property Value

Type	Description
Microsoft.UI.Xaml.Media.Brush	It takes the Microsoft.UI.Xaml.Media.Brush value.

PlotAreaBorderBrush

Gets or sets the color to paint the outline of chart area.

Declaration

public Brush PlotAreaBorderBrush { get; set; }

Property Value

Type	Description
Microsoft.UI.Xaml.Media.Brush	It takes the Microsoft.UI.Xaml.Media.Brush value.

PlotAreaBorderThickness

Gets or sets the outline thickness of chart area.

Declaration

public Thickness PlotAreaBorderThickness { get; set; }

Property Value

Type	Description
Microsoft.UI.Xaml.Thickness	Default value is 0 and it takes the Microsoft.UI.Xaml.Thickness value.

PrimaryAxis

Gets or sets primary axis for SfCartesianChart.

Declaration

public ChartAxisBase2D PrimaryAxis { get; set; }

Property Value

Type	Description
ChartAxisBase2D	It takes the ChartAxisBase2D value.

Examples

• MainWindow.xaml
• MainWindow.cs

    <chart:SfCartesianChart>

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

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

    </chart:SfCartesianChart>

SecondaryAxis

Gets or sets secondary axis for SfCartesianChart.

Declaration

public RangeAxisBase SecondaryAxis { get; set; }

Property Value

Type	Description
RangeAxisBase	It takes the RangeAxisBase value.

Examples

• MainWindow.xaml
• MainWindow.cs

    <chart:SfCartesianChart>

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

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

    </chart:SfCartesianChart>

Series

Gets or sets a collection of series to be added to the chart. To render a series, create an instance of required series class, and add it to the collection.

Declaration

public CartesianSeriesCollection Series { get; set; }

Property Value

Type	Description
CartesianSeriesCollection	It takes the CartesianSeriesCollection value.

Examples

• MainWindow.xaml
• MainWindow.cs
• ViewModel.cs

    <chart:SfCartesianChart>

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

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

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

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

    </chart:SfCartesianChart>

Methods

PointToValue(ChartAxis, Point)

Converts screen point to chart value.

Declaration

public double PointToValue(ChartAxis axis, Point point)

Parameters

Type	Name	Description
ChartAxis	axis	The axis value.
Windows.Foundation.Point	point	The point.

Returns

Type	Description
System.Double	The double point to value.

ValueToPoint(ChartAxis, Double)

Converts Value to point.

Declaration

public double ValueToPoint(ChartAxis axis, double value)

Parameters

Type	Name	Description
ChartAxis	axis	The Chart axis .
System.Double	value	The value.

Returns

Type	Description
System.Double	The double value to point.

Implements

System.IDisposable