[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications, and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Gantt Control
  [Collapse]Chart Control
   [Expand]Getting Started
   [Expand]Charting Basics
   [Collapse]Series Views
    [Collapse]2D Series Views
     [Expand]Area Series Views
     [Expand]Bar Series Views
     [Expand]Financial Series Views
      Box Plot Chart
     [Expand]Gantt Series Views
     [Expand]Pie and Donut Series Views
     [Expand]Point and Line Series Views
     [Expand]Radar Series Views
     [Expand]Polar Series Views
      Funnel Series View
      Swift Plot Series View
    [Expand]3D Series Views
     Series Views Compatibility
   [Expand]Chart Elements
   [Expand]Providing Data
   [Expand]Data Representation
   [Expand]Appearance Customization
   [Expand]End-User Features
   [Expand]Design-Time Features
   [Expand]Visual Elements
   [Expand]Examples
   [Expand]Additional Resources
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Box Plot Chart

The Box Plot (also called Box-and-Whisker Plot) chart is used to analyze statistic-driven data points. To draw a Box Plot point, you must pass the Min, Quartile1, Median, Quartile3 and Max parameters. You can optionally display a set of Outliers and a Mean value.

Demo: Box Plot

Expanded Chart Type Characteristics

The table below lists the main box plot chart characteristics:

Feature Value
Series view type BoxPlotSeriesView
Diagram type 2D XYDiagram
Number of arguments per series point 1
Number of values per series point 7

The following image shows the Box Plot chart elements:

Expanded Limitations

The Box Plot series view does not support series labels.

Expanded Create a Box Plot Chart

The following example demonstrates how to create a Box Plot chart with three points:

  • Add a chart to the WinForms project and specify the chart's data source.
  • Create a new series and add it to the chart. Set its view type to BoxPlot.
  • Specify data members for the series.

    You can call the SeriesBase.SetBoxPlotDataMembersWithOutliers method to pass all the data member names as parameters. To create a chart without outliers, use the SeriesBase.SetBoxPlotDataMembers method.

    To keep the Mean parameter undefined, pass the MeanDataMember parameter as null or an empty string to the SeriesBase.SetBoxPlotDataMembersWithOutliers (SeriesBase.SetBoxPlotDataMembers) method. If you manually add SeriesPoint objects to the Series.Points collection, you can set the SeriesPoint.Values value to double.NaN, DateTime.MinValue or TimeSpan.Zero.

Expanded Format the Crosshair Label

Use the SeriesBase.CrosshairLabelPattern property to format the crosshair label text.

The Chart Control provides the following placeholders that you can use in patterns:

Placeholder Description
{BP_MIN} Displays the Box Plot point's Minimum value.
{BP_Q1} Displays the Box Plot point's First Quartile value.
{BP_MDN} Displays the Box Plot point's Median value.
{BP_AVG} Displays the Box Plot point's Mean value.
{BP_Q3} Displays the Box Plot point's Third Quartile value.
{BP_MAX} Displays the Box Plot point's Maximum value.

You can use Format Specifiers to format values that the placeholders show. For example, the "{BP_Q1:f1}" pattern displays the First Quartile value with one digit after a comma.

Expanded Change Chart Appearance

This section explains how to modify the Box Plot chart appearance as follows:

The BoxPlotSeriesView class exposes the following appearance settings for the Box Plot chart:

Is this topic helpful?​​​​​​​