HistogramSeries Class

Displays data as a histogram chart.

Namespace: DevExpress.Docs.Office

Assembly: DevExpress.Docs.Core.v26.1.dll

NuGet Package: DevExpress.Docs.Core

Declaration

C#

public class HistogramSeries :
    DataSeriesExBase

VB.NET

Public Class HistogramSeries
    Inherits DataSeriesExBase

Related API Members

The following members return HistogramSeries objects:

• HistogramSeries.Clone()
• ParetoSeries.HistogramSeries

Remarks

The following code snippet creates a histogram series and adds it to a chart:

C#

using DevExpress.Docs.Office;
using DevExpress.Docs.Presentation;

using System.Drawing;
namespace PresentationApiSample;

public class Program {
    public static async Task Main(string[] _) {
        // Create a presentation.
        Presentation presentation = new Presentation();

        // Reset the slide collection.
        presentation.Slides.Clear();

        // Add a blank slide.
        Slide slide = new Slide(SlideLayoutType.Blank);
        presentation.Slides.Add(slide);

        // Insert a chart on the slide.
        ChartEx chart = new ChartEx();
        slide.Shapes.Add(chart);

        // Set chart size to match the slide.
        chart.Width = presentation.SlideSize.Width;
        chart.Height = presentation.SlideSize.Height;

        // Create a histogram series and assign values.
        HistogramSeries series = new HistogramSeries();
        series.Values = new ChartNumericData(new double[] { 1, 2, 3, 2, 13, 12, 19, 34, 22, 21, 34, 30, 18, 16, 33});

        // Configure histogram bins.
        series.BinType = HistogramBinType.BinSize;
        series.BinSize = 10;

        // Add the series to the chart.
        chart.Series.Add(series);

        // Display and format data labels.
        series.DataLabels.ShowValue = true;
        series.DataLabels.TextProperties = new TextProperties { FontSize = 24, Fill = new SolidFill(Color.Magenta) };

        // Set argument axis label formatting.
        CategoryAxisEx? xAxis = chart.ArgumentAxis;
        if (xAxis != null) {
            xAxis.LabelTextProperties = new TextProperties { FontSize = 24 };
        }

        // Hide the chart legend.
        chart.Legend = null;

        // Save the result to a file.
        var outputPath = @"D:\presentation.pptx";
        using FileStream outputStream = new(outputPath, FileMode.Create, FileAccess.Write, FileShare.None);
        presentation.SaveDocument(outputStream);
    }
}

VB.NET

Imports DevExpress.Docs.Office
Imports DevExpress.Docs.Presentation

Imports System.Drawing
Imports System.IO
Imports System.Threading.Tasks

Namespace PresentationApiSample

  Public Class Program
    Public Shared Async Function Main(args As String()) As Task
      ' Create a presentation.
      Dim presentation As New Presentation()

      ' Reset the slide collection.
      presentation.Slides.Clear()

      ' Add a blank slide.
      Dim slide As New Slide(SlideLayoutType.Blank)
      presentation.Slides.Add(slide)

      ' Insert a chart on the slide.
      Dim chart As New ChartEx()
      slide.Shapes.Add(chart)

      ' Set chart size to match the slide.
      chart.Width = presentation.SlideSize.Width
      chart.Height = presentation.SlideSize.Height

      ' Create a histogram series and assign values.
      Dim series As New HistogramSeries()
      series.Values = New ChartNumericData(New Double() {
        1, 2, 3, 2, 13, 12, 19, 34, 22, 21, 34, 30, 18, 16, 33
      })

      ' Configure histogram bins.
      series.BinType = HistogramBinType.BinSize
      series.BinSize = 10

      ' Add the series to the chart.
      chart.Series.Add(series)

      ' Display and format data labels.
      series.DataLabels.ShowValue = True
      series.DataLabels.TextProperties = New TextProperties With {
        .FontSize = 24,
        .Fill = New SolidFill(Color.Magenta)
      }

      ' Set argument axis label formatting.
      Dim xAxis As CategoryAxisEx = TryCast(chart.ArgumentAxis, CategoryAxisEx)
      If xAxis IsNot Nothing Then
        xAxis.LabelTextProperties = New TextProperties With {.FontSize = 24}
      End If

      ' Hide the chart legend.
      chart.Legend = Nothing

      ' Save the result to a file.
      Dim outputPath = "D:\presentation.pptx"
      Using outputStream As New FileStream(outputPath, FileMode.Create, FileAccess.Write, FileShare.None)
        presentation.SaveDocument(outputStream)
      End Using
    End Function
  End Class
End Namespace

Implements

ICloneable

Inheritance

Object

OfficeObject

SeriesExBase

DataSeriesExBase

HistogramSeries