Class HistogramSeries

The HistogramSeries displays the distribution of a dataset by dividing it into intervals and showing the count of values within each interval.

Inheritance
System.Object
ChartSeries
CartesianSeries
XYDataSeries
HistogramSeries
Inherited Members
Namespace: Syncfusion.Maui.Charts
Assembly: Syncfusion.Maui.Charts.dll
Syntax
public class HistogramSeries : XYDataSeries, IDatapointSelectionDependent, ITooltipDependent, IDataTemplateDependent, IDrawCustomLegendIcon
Remarks

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

It provides options for Fill, PaletteBrushes, StrokeWidth, Stroke, and Opacity to customize the appearance.

EnableTooltip - A tooltip displays information while tapping or mouse hovering above a segment. To display the tooltip on a chart, you need to set the EnableTooltip property as true in HistogramSeries class, and also refer TooltipBehavior property.

Data Label - Data labels are used to display values related to a chart segment. To render the data labels, you need to set the ShowDataLabels property as true in HistogramSeries class. To customize the chart data labels alignment, placement, and label styles, you need to create an instance of CartesianDataLabelSettings and set to the DataLabelSettings property.

Animation - To animate the series, set True to the EnableAnimation property.

LegendIcon - To customize the legend icon using the LegendIcon property.

Examples
    <chart:SfCartesianChart>

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

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

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

    </chart:SfCartesianChart>

Constructors

HistogramSeries()

Initializes a new instance of the HistogramSeries class.

Declaration
public HistogramSeries()

Fields

CurveStyleProperty

Identifies the CurveStyle bindable property.

Declaration
public static readonly BindableProperty CurveStyleProperty
Field Value
Type
Microsoft.Maui.Controls.BindableProperty

HistogramIntervalProperty

Identifies the HistogramInterval bindable property.

Declaration
public static readonly BindableProperty HistogramIntervalProperty
Field Value
Type
Microsoft.Maui.Controls.BindableProperty

ShowNormalDistributionCurveProperty

Identifies the ShowNormalDistributionCurve bindable property.

Declaration
public static readonly BindableProperty ShowNormalDistributionCurveProperty
Field Value
Type
Microsoft.Maui.Controls.BindableProperty

StrokeProperty

Identifies the Stroke bindable property.

Declaration
public static readonly BindableProperty StrokeProperty
Field Value
Type
Microsoft.Maui.Controls.BindableProperty

Properties

CurveStyle

Gets or sets the histogram curve style.

Declaration
public ChartLineStyle CurveStyle { get; set; }
Property Value
Type Description
ChartLineStyle

It accepts ChartLineStyle values.
Remarks

Null values are invalid.

Examples
    <chart:SfCartesianChart>

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

         <chart:HistogramSeries ItemsSource="{Binding Data}"
                             XBindingPath="XValue"
                             YBindingPath="YValue"
                             Stroke="Red">
            <chart:HistogramSeries.CurveStyle>
              <chart:ChartLineStyle Stroke ="Red" StrokeWidth ="2"/>
             <chart:HistogramSeries.CurveStyle>
    </chart:SfCartesianChart>

HistogramInterval

Gets or sets the histogram interval.

Declaration
public double HistogramInterval { get; set; }
Property Value
Type Description
System.Double

It accepts System.Double values and its default value is 1.
Examples
    <chart:SfCartesianChart>

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

         <chart:HistogramSeries ItemsSource="{Binding Data}"
                             XBindingPath="XValue"
                             YBindingPath="YValue"
                             HistogramInterval="10" />

    </chart:SfCartesianChart>

ShowNormalDistributionCurve

Gets or sets a value indicating whether to show the normal distribution curve.

Declaration
public bool ShowNormalDistributionCurve { get; set; }
Property Value
Type Description
System.Boolean

It accepts System.Boolean values and its default value is true.
Examples
    <chart:SfCartesianChart>

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

         <chart:HistogramSeries ItemsSource="{Binding Data}"
                             XBindingPath="XValue"
                             YBindingPath="YValue"
                             ShowNormalDistributionCurve="True" />

    </chart:SfCartesianChart>

Stroke

Get or set the stoke of the Histogram segments.

Declaration
public Brush Stroke { get; set; }
Property Value
Type Description
Microsoft.Maui.Controls.Brush

It accepts Microsoft.Maui.Controls.Brush values and its default value is Transparent.
Examples
    <chart:SfCartesianChart>

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

         <chart:HistogramSeries ItemsSource="{Binding Data}"
                             XBindingPath="XValue"
                             YBindingPath="YValue"
                             Stroke = "Red" />

    </chart:SfCartesianChart>

Methods

CreateSegment()

Declaration
protected override ChartSegment CreateSegment()
Returns
Type
ChartSegment
Overrides

DrawSeries(ICanvas, ReadOnlyObservableCollection<ChartSegment>, RectF)

Declaration
protected override void DrawSeries(ICanvas canvas, ReadOnlyObservableCollection<ChartSegment> segments, RectF clipRect)
Parameters
Type Name Description
Microsoft.Maui.Graphics.ICanvas canvas
System.Collections.ObjectModel.ReadOnlyObservableCollection<ChartSegment> segments
Microsoft.Maui.Graphics.RectF clipRect
Overrides

See Also