Class ErrorBarSeries

The ErrorBarSeries indicate the uncertainty or error in data points, making it easy to identify patterns and trends in the data.

Inheritance

System.Object

ChartSeries

CartesianSeries

XYDataSeries

ErrorBarSeries

Inherited Members

CartesianSeries.ActualXAxis

CartesianSeries.ActualYAxis

CartesianSeries.DataLabelSettings

CartesianSeries.DataLabelSettingsProperty

CartesianSeries.GetDataPoints(Double, Double, Double, Double)

CartesianSeries.GetDataPoints(Rect)

CartesianSeries.Label

CartesianSeries.LabelProperty

CartesianSeries.OnBindingContextChanged()

CartesianSeries.ShowTrackballLabel

CartesianSeries.ShowTrackballLabelProperty

CartesianSeries.TrackballLabelTemplate

CartesianSeries.TrackballLabelTemplateProperty

CartesianSeries.XAxisName

CartesianSeries.XAxisNameProperty

CartesianSeries.YAxisName

CartesianSeries.YAxisNameProperty

ChartSeries.CreateAnimation(Action<Double>)

ChartSeries.DrawDataLabel(ICanvas, Brush, String, PointF, Int32)

ChartSeries.DrawSeries(ICanvas, ReadOnlyObservableCollection<ChartSegment>, RectF)

ChartSeries.EnableAnimation

ChartSeries.EnableAnimationProperty

ChartSeries.EnableTooltip

ChartSeries.EnableTooltipProperty

ChartSeries.Fill

ChartSeries.FillProperty

ChartSeries.GetDataPointIndex(Single, Single)

ChartSeries.IsVisible

ChartSeries.IsVisibleOnLegend

ChartSeries.IsVisibleOnLegendProperty

ChartSeries.IsVisibleProperty

ChartSeries.ItemsSource

ChartSeries.ItemsSourceProperty

ChartSeries.LabelContext

ChartSeries.LabelContextProperty

ChartSeries.LabelTemplate

ChartSeries.LabelTemplateProperty

ChartSeries.LegendIcon

ChartSeries.LegendIconProperty

ChartSeries.Opacity

ChartSeries.OpacityProperty

ChartSeries.PaletteBrushes

ChartSeries.PaletteBrushesProperty

ChartSeries.SelectionBehavior

ChartSeries.SelectionBehaviorProperty

ChartSeries.ShowDataLabels

ChartSeries.ShowDataLabelsProperty

ChartSeries.TooltipTemplate

ChartSeries.TooltipTemplateProperty

ChartSeries.XBindingPath

ChartSeries.XBindingPathProperty

ChartSeries.XRange

ChartSeries.YRange

XYDataSeries.StrokeWidth

XYDataSeries.StrokeWidthProperty

XYDataSeries.YBindingPath

XYDataSeries.YBindingPathProperty

Namespace: Syncfusion.Maui.Charts

Assembly: Syncfusion.Maui.Charts.dll

Syntax

public class ErrorBarSeries : XYDataSeries, IDatapointSelectionDependent, ITooltipDependent, IDataTemplateDependent, IDrawCustomLegendIcon

Remarks

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

The ErrorBarSeries had no tooltip, data label, animation, and selection support.

Examples

    <chart:SfCartesianChart>

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

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

          <chart:SfCartesianChart.Series>
             <chart:ErrorBarSeries ItemsSource="{Binding ThermalExpansion}"   
                                                    XBindingPath="Name"   
                                                    YBindingPath="Value"/>
          </chart:SfCartesianChart.Series>  
    </chart:SfCartesianChart>

    SfCartesianChart chart = new SfCartesianChart();

    NumericalAxis xAxis = new CategoryAxis();
    NumericalAxis yAxis = new NumericalAxis();

    chart.XAxes.Add(xAxis);
    chart.YAxes.Add(yAxis);

    ViewModel viewModel = new ViewModel();

    ErrorBarSeries series = new ErrorBarSeries();
    series.ItemsSource = viewModel.ThermalExpansion;
    series.XBindingPath = "Name";
    series.YBindingPath = "Value";
    chart.Series.Add(series);

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

    public ViewModel()
    {
       ThermalExpansion = new ObservableCollection<Model>();
       ThermalExpansion.Add(new Model() { Name="Erbium",Value=8.2,High=7.6 });
       ThermalExpansion.Add(new Model() { Name="Samarium",Value=8.15,High=5.7 });
       ThermalExpansion.Add(new Model() { Name="Yttritium",Value=7.15,High=6.8 });
       ThermalExpansion.Add(new Model() { Name="Carbide",Value=6.45,High=5.9 });
       ThermalExpansion.Add(new Model() { Name="Uranium",Value=7.45,High=7.1 });
       ThermalExpansion.Add(new Model() { Name="Iron",Value=6.7,High=5 });
       ThermalExpansion.Add(new Model() { Name="Thuilium",Value=8.45,High=7.1 });
       ThermalExpansion.Add(new Model() { Name="Steel",Value=9.7,High=8.6});
       ThermalExpansion.Add(new Model() { Name="Tin",Value=14.6,High=10.8 });
       ThermalExpansion.Add(new Model() { Name="Uranium",Value=7.45,High=7.1 });
    }

Constructors

ErrorBarSeries()

Initializes a new instance of the ErrorBarSeries class.

Declaration

public ErrorBarSeries()

Fields

HorizontalCapLineStyleProperty

Identifies the HorizontalCapLineStyle bindable property.

Declaration

public static readonly BindableProperty HorizontalCapLineStyleProperty

Field Value

Type
Microsoft.Maui.Controls.BindableProperty

HorizontalDirectionProperty

Identifies the HorizontalDirection bindable property.

Declaration

public static readonly BindableProperty HorizontalDirectionProperty

Field Value

Type
Microsoft.Maui.Controls.BindableProperty

HorizontalErrorPathProperty

Identifies the HorizontalErrorPath bindable property.

Declaration

public static readonly BindableProperty HorizontalErrorPathProperty

Field Value

Type
Microsoft.Maui.Controls.BindableProperty

HorizontalErrorValueProperty

Identifies the HorizontalErrorValue bindable property.

Declaration

public static readonly BindableProperty HorizontalErrorValueProperty

Field Value

Type
Microsoft.Maui.Controls.BindableProperty

HorizontalLineStyleProperty

Identifies the HorizontalLineStyle bindable property.

Declaration

public static readonly BindableProperty HorizontalLineStyleProperty

Field Value

Type
Microsoft.Maui.Controls.BindableProperty

ModeProperty

Identifies the Mode bindable property.

Declaration

public static readonly BindableProperty ModeProperty

Field Value

Type
Microsoft.Maui.Controls.BindableProperty

TypeProperty

Identifies the Type bindable property.

Declaration

public static readonly BindableProperty TypeProperty

Field Value

Type
Microsoft.Maui.Controls.BindableProperty

VerticalCapLineStyleProperty

Identifies the VerticalCapLineStyle bindable property.

Declaration

public static readonly BindableProperty VerticalCapLineStyleProperty

Field Value

Type
Microsoft.Maui.Controls.BindableProperty

VerticalDirectionProperty

Identifies the VerticalDirection bindable property.

Declaration

public static readonly BindableProperty VerticalDirectionProperty

Field Value

Type
Microsoft.Maui.Controls.BindableProperty

VerticalErrorPathProperty

Identifies the VerticalErrorPath bindable property.

Declaration

public static readonly BindableProperty VerticalErrorPathProperty

Field Value

Type
Microsoft.Maui.Controls.BindableProperty

VerticalErrorValueProperty

Identifies the VerticalErrorValue bindable property.

Declaration

public static readonly BindableProperty VerticalErrorValueProperty

Field Value

Type
Microsoft.Maui.Controls.BindableProperty

VerticalLineStyleProperty

Identifies the VerticalLineStyle bindable property.

Declaration

public static readonly BindableProperty VerticalLineStyleProperty

Field Value

Type
Microsoft.Maui.Controls.BindableProperty

Properties

HorizontalCapLineStyle

Gets or sets the style for horizontal caps, and it is often used to customize the appearance of horizontal caps in the error bar for visual purposes.

Declaration

public ErrorBarCapLineStyle HorizontalCapLineStyle { get; set; }

Property Value

Type	Description
ErrorBarCapLineStyle	Its default is null.

    <chart:SfCartesianChart>

    <!-- ... Eliminated for simplicity-->

          <chart:ErrorBarSeries ItemsSource="{Binding ThermalExpansion}"   
                                                    XBindingPath="Name"   
                                                    YBindingPath="Value"
                                                    HorizontalErrorValue=0.25
                                                    VerticalErrorValue="5"/>                   
                   <chart:ErrorBarSeries.HorizontalCapLineStyle>
                  <chart:ErrorBarCapLineStyle Stroke="Black"></chart:ErrorBarCapLineStyle>
         </chart:ErrorBarSeries.HorizontalCapLineStyle>

    </chart:SfCartesianChart>

    SfCartesianChart chart = new SfCartesianChart();
    ViewModel viewModel = new ViewModel();

    // Eliminated for simplicity

    ErrorBarSeries errorBarSeries = new ErrorBarSeries()
    {
          ItemsSource = viewModel.Data,
          XBindingPath = "Name",
          YBindingPath = "Value",
          HorizontalErrorValue=0.25,
          VerticalErrorValue="5"
    };
    errorBarSeries.HorizontalCapLineStyle = new ErrorBarCapLineStyle()
    {
         Stroke = new SolidColorBrush(Colors.Black),
     }

    chart.Series.Add(errorBarSeries);

HorizontalDirection

Gets or sets the direction to specify whether to show positive, negative or both directions of horizontal error values to display.

Declaration

public ErrorBarDirection HorizontalDirection { get; set; }

Property Value

Type	Description
ErrorBarDirection	Its defaults is Both

Examples

Xaml
C#

    <chart:SfCartesianChart>

    <!-- ... Eliminated for simplicity-->

          <chart:ErrorBarSeries ItemsSource="{Binding ThermalExpansion}"   
                                                    XBindingPath="Name"   
                                                    YBindingPath="Value"
                                                    HorizontalErrorValue=0.25,
                                                    VerticalErrorValue="5"
                                                    HorizontalDirection="Both"/>

    </chart:SfCartesianChart>

    SfCartesianChart chart = new SfCartesianChart();
    ViewModel viewModel = new ViewModel();

    // Eliminated for simplicity

    ErrorBarSeries errorBarSeries = new ErrorBarSeries()
    {
          ItemsSource = viewModel.Data,
          XBindingPath = "Name",
          YBindingPath = "Value",
          HorizontalErrorValue=0.25,
          VerticalErrorValue="5"
          HorizontalDirection=ErrorBarDirection.Both
    };

    chart.Series.Add(errorBarSeries);

HorizontalErrorPath

Gets or sets a path value on the source object to serve a horizontal error value to the series.

Declaration

public string HorizontalErrorPath { get; set; }

Property Value

Type	Description
System.String	It accepts System.String and the default `String.Empty`.

Remarks

If the HorizontalErrorPath is set, the HorizontalErrorValue will be ignored when type is Custom.

Examples

Xaml
C#

    <chart:SfCartesianChart>

    <!-- ... Eliminated for simplicity-->

          <chart:ErrorBarSeries ItemsSource="{Binding ThermalExpansion}"   
                                                    XBindingPath="Name" 
                                                    YBindingPath="Value"
                                                    HorizontalErrorPath="Low"/>
    </chart:SfCartesianChart>

    SfCartesianChart chart = new SfCartesianChart();
    ViewModel viewModel = new ViewModel();

    // Eliminated for simplicity

    ErrorBarSeries errorBarSeries = new ErrorBarSeries()
    {
          ItemsSource = viewModel.Data,
          XBindingPath = "Name",
          YBindingPath="Value",
          HorizontalErrorPath="Low"
    };

    chart.Series.Add(errorBarSeries);

HorizontalErrorValue

Gets or sets the value of the horizontal errors of the series.

Declaration

public double HorizontalErrorValue { get; set; }

Property Value

Type	Description
System.Double	It accepts System.Double and the default is 0.

Remarks

The HorizontalErrorValue works when there is no HorizontalErrorPath set and the Mode is Both or Horizontal.

Examples

Xaml
C#

    <chart:SfCartesianChart>

    <!-- ... Eliminated for simplicity-->

          <chart:ErrorBarSeries ItemsSource="{Binding ThermalExpansion}"   
                                                    XBindingPath="Name"   
                                                    YBindingPath="Value"
                                                   HorizontalErrorValue="0.25"/>

    </chart:SfCartesianChart>

    SfCartesianChart chart = new SfCartesianChart();
    ViewModel viewModel = new ViewModel();

    // Eliminated for simplicity

    ErrorBarSeries errorBarSeries = new ErrorBarSeries()
    {
          ItemsSource = viewModel.Data,
          XBindingPath = "Name",
          YBindingPath = "Value",
          HorizontalErrorValue="0.25",
    };

    chart.Series.Add(errorBarSeries);

HorizontalLineStyle

Gets or sets the style for horizontal lines, and it is often used to customize the appearance of horizontal error bars for visual purposes.

Declaration

public ErrorBarLineStyle HorizontalLineStyle { get; set; }

Property Value

Type	Description
ErrorBarLineStyle	Its default is null.

Examples

Xaml
C#

    <chart:SfCartesianChart>

    <!-- ... Eliminated for simplicity-->

          <chart:ErrorBarSeries ItemsSource="{Binding ThermalExpansion}"   
                                                    XBindingPath="Name"   
                                                    YBindingPath="Value"
                                                    HorizontalErrorValue=0.25,
                                                    VerticalErrorValue="5"/>

                   <chart:ErrorBarSeries.HorizontalLineStyle>
                  <chart:ErrorBarLineStyle Stroke = "Black" ></ chart:ErrorBarLineStyle>
         </chart:ErrorBarSeries.HorizontalLineStyle>

    </chart:SfCartesianChart>

    SfCartesianChart chart = new SfCartesianChart();
    ViewModel viewModel = new ViewModel();

    // Eliminated for simplicity

    ErrorBarSeries errorBarSeries = new ErrorBarSeries()
    {
          ItemsSource = viewModel.Data,
          XBindingPath = "Name",
          YBindingPath = "Value",
          HorizontalErrorValue=0.25,
          VerticalErrorValue="5"
    };
    errorBarSeries.HorizontalLineStyle = new ErrorBarLineStyle()
    {
         Stroke = new SolidColorBrush(Colors.Black),
     }
    chart.Series.Add(errorBarSeries);

Mode

Gets or sets the mode of the error bar to be displayed, whether horizontal, vertical, or both.

Declaration

public ErrorBarMode Mode { get; set; }

Property Value

Type	Description
ErrorBarMode	Its defaults is Both

Examples

Xaml
C#

    <chart:SfCartesianChart>

    <!-- ... Eliminated for simplicity-->

     <chart:ErrorBarSeries ItemsSource="{Binding ThermalExpansion}"   
                                                 XBindingPath="Name"   
                                                 YBindingPath="Value"
                                                 HorizontalErrorValue=0.25
                                                 VerticalErrorValue=5
                                                 Mode="Both"/>
    </chart:SfCartesianChart>

    SfCartesianChart chart = new SfCartesianChart();
    ViewModel viewModel = new ViewModel();

    // Eliminated for simplicity

    ErrorBarSeries errorBarSeries = new ErrorBarSeries()
    {
          ItemsSource = viewModel.Data,
          XBindingPath = "Name",
          YBindingPath = "Value",
          HorizontalErrorValue=0.25,
          VerticalErrorValue="5",
          Mode=ErrorBarMode.Both
    };

    chart.Series.Add(errorBarSeries);

Type

Gets or sets the error bar type, whether it is specified as a standard deviation, a standard error, a percentage, or a fixed value.

Declaration

public ErrorBarType Type { get; set; }

Property Value

Type	Description
ErrorBarType	Its defaults is Fixed

Examples

Xaml
C#

    <chart:SfCartesianChart>

    <!-- ... Eliminated for simplicity-->

          <chart:ErrorBarSeries ItemsSource="{Binding ThermalExpansion}"   
                                                    XBindingPath="Name"   
                                                    YBindingPath="Value"
                                                    HorizontalErrorValue=0.25
                                                    VerticalErrorValue=5
                                                    Type="Fixed"/>
    </chart:SfCartesianChart>

    SfCartesianChart chart = new SfCartesianChart();
    ViewModel viewModel = new ViewModel();

    // Eliminated for simplicity

    ErrorBarSeries errorBarSeries = new ErrorBarSeries()
    {
          ItemsSource = viewModel.Data,
          XBindingPath = "Name",
          YBindingPath = "Value",
          HorizontalErrorValue=0.25,
          VerticalErrorValue="5",
          Type=ErrorBarType.Fixed
    };

    chart.Series.Add(errorBarSeries);

VerticalCapLineStyle

Gets or sets the style for vertical caps, and it is often used to customize the appearance of vertical caps in the error bar for visual purposes.

Declaration

public ErrorBarCapLineStyle VerticalCapLineStyle { get; set; }

Property Value

Type	Description
ErrorBarCapLineStyle	Its default is null.

Examples

Xaml
C#

    <chart:SfCartesianChart>

    <!-- ... Eliminated for simplicity-->

          <chart:ErrorBarSeries ItemsSource="{Binding ThermalExpansion}"   
                                                    XBindingPath="Name"   
                                                    YBindingPath="Value"
                                                    HorizontalErrorValue=0.25
                                                    VerticalErrorValue="5"/>

                   <chart:ErrorBarSeries.VerticalCapLineStyle>
                  <chart:ErrorBarCapLineStyle Stroke="Black" CapSize="20"></chart:ErrorBarCapLineStyle>
         </chart:ErrorBarSeries.VerticalCapLineStyle>

    </chart:SfCartesianChart>

    SfCartesianChart chart = new SfCartesianChart();
    ViewModel viewModel = new ViewModel();

    // Eliminated for simplicity

    ErrorBarSeries errorBarSeries = new ErrorBarSeries()
    {
          ItemsSource = viewModel.Data,
          XBindingPath = "Name",
          YBindingPath = "Value",
          HorizontalErrorValue=0.25,
          VerticalErrorValue="5"
    };
    errorBarSeries.VerticalCapLineStyle = new ErrorBarCapLineStyle()
    {
         Stroke = new SolidColorBrush(Colors.Black),
         CapSize=20;
     }

    chart.Series.Add(errorBarSeries);

VerticalDirection

Gets or sets the direction to specify whether to show positive, negative or both directions of vertical error values to display.

Declaration

public ErrorBarDirection VerticalDirection { get; set; }

Property Value

Type	Description
ErrorBarDirection	Its defaults to Both

Examples

Xaml
C#

    <chart:SfCartesianChart>

    <!-- ... Eliminated for simplicity-->

          <chart:ErrorBarSeries ItemsSource="{Binding ThermalExpansion}"   
                                                    XBindingPath="Name"   
                                                    YBindingPath="Value"
                                                    HorizontalErrorValue=0.25,
                                                    VerticalErrorValue="5"
                                                    VerticalDirection="Both"/>

    </chart:SfCartesianChart>

    SfCartesianChart chart = new SfCartesianChart();
    ViewModel viewModel = new ViewModel();

    // Eliminated for simplicity

    ErrorBarSeries errorBarSeries = new ErrorBarSeries()
    {
          ItemsSource = viewModel.Data,
          XBindingPath = "Name",
          YBindingPath = "Value",
          HorizontalErrorValue=0.25,
          VerticalErrorValue="5"
          VerticalDirection=ErrorBarDirection.Both
    };

    chart.Series.Add(errorBarSeries);

VerticalErrorPath

Gets or sets a path value on the source object to serve a vertical error value to the series.

Declaration

public string VerticalErrorPath { get; set; }

Property Value

Type	Description
System.String	It accepts System.Stringand the default is `String.Empty`.

Remarks

If the VerticalErrorPath is set, the VerticalErrorValue will be ignored when type is Custom.

Examples

Xaml
C#

    <chart:SfCartesianChart>

    <!-- ... Eliminated for simplicity-->

     <chart:ErrorBarSeries ItemsSource="{Binding ThermalExpansion}"    
                                                 YBindingPath="Value"
                                                 XBindingPath = "Name"
                                                 VerticalErrorPath="High"/>

    </chart:SfCartesianChart>

    SfCartesianChart chart = new SfCartesianChart();
    ViewModel viewModel = new ViewModel();

    // Eliminated for simplicity

    ErrorBarSeries errorBarSeries = new ErrorBarSeries()
    {
          ItemsSource = viewModel.Data,
          XBindingPath = "Name",
          YBindingPath = "Value",
          VerticalErrorPath="High"
    };

    chart.Series.Add(errorBarSeries);

VerticalErrorValue

Gets or sets the value of the vertical errors of the series.

Declaration

public double VerticalErrorValue { get; set; }

Property Value

Type	Description
System.Double	It accepts System.Double and the default is 0.

Remarks

The VerticalErrorValue works when there is no VerticalErrorPath set and the Mode is Both or Vertical.

Examples

Xaml
C#

    <chart:SfCartesianChart>

    <!-- ... Eliminated for simplicity-->

          <chart:ErrorBarSeries ItemsSource="{Binding ThermalExpansion}"   
                                                    XBindingPath="Name"   
                                                    YBindingPath="Value"
                                                    VerticalErrorValue="5"/>
    </chart:SfCartesianChart>

    SfCartesianChart chart = new SfCartesianChart();
    ViewModel viewModel = new ViewModel();

    // Eliminated for simplicity

    ErrorBarSeries errorBarSeries = new ErrorBarSeries()
    {
          ItemsSource = viewModel.Data,
          XBindingPath = "Name",
          YBindingPath = "Value",
          VerticalErrorValue="5"
    };

    chart.Series.Add(errorBarSeries);

VerticalLineStyle

Gets or sets the style for vertical lines, and it is often used to customize the appearance of the vertical error bar for visual purposes.

Declaration

public ErrorBarLineStyle VerticalLineStyle { get; set; }

Property Value

Type	Description
ErrorBarLineStyle	Its default is null.

Examples

Xaml
C#

    <chart:SfCartesianChart>

    <!-- ... Eliminated for simplicity-->

          <chart:ErrorBarSeries ItemsSource="{Binding ThermalExpansion}"   
                                                    XBindingPath="Name"   
                                                    YBindingPath="Value"
                                                    HorizontalErrorValue=0.25
                                                    VerticalErrorValue="5"/>

                   <chart:ErrorBarSeries.VerticalLineStyle>
                  <chart:ErrorBarLineStyle Stroke = "Black" ></ chart:ErrorBarLineStyle>
         </chart:ErrorBarSeries.VerticalLineStyle>

    </chart:SfCartesianChart>

    SfCartesianChart chart = new SfCartesianChart();
    ViewModel viewModel = new ViewModel();

    // Eliminated for simplicity

    ErrorBarSeries errorBarSeries = new ErrorBarSeries()
    {
          ItemsSource = viewModel.Data,
          XBindingPath = "Name",
          YBindingPath = "Value",
          HorizontalErrorValue=0.25,
          VerticalErrorValue="5"
    };
    errorBarSeries.VerticalLineStyle = new ErrorBarLineStyle()
    {
         Stroke = new SolidColorBrush(Colors.Black),
     }

    chart.Series.Add(errorBarSeries);

Methods

CreateSegment()

Creates the Error Bar segments.

Declaration

protected override ChartSegment CreateSegment()

Returns

Type
ChartSegment

Overrides

ChartSeries.CreateSegment()