[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [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
   [Expand]Series Views
   [Collapse]Chart Elements
     [Expand]Diagram Types
       Adding Panes
       Pane Title
       Pane Layout
       Panes Appearance
     Chart Titles
   [Expand]Providing Data
   [Expand]Data Representation
   [Expand]Appearance Customization
   [Expand]End-User Features
   [Expand]Design-Time Features
   [Expand]Visual Elements
   [Expand]Additional Resources
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [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]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)


This document describes the fundamental concepts of panes in XtraCharts, including their purpose, implementation and capabilities. It also describes how secondary axes can be distributed among multiple panes, and the ways in which scrolling can be implemented. To learn more about chart elements and their hierarchy in XtraCharts, refer to the Chart Elements topic.

Panes are the visual areas within a chart's diagram (for the XY-Diagram 2D chart type only). All elements belonging to the Diagram object (Axes, Strips, Constant Lines, etc.) and the chart's Series, are displayed within the Panes.

It is possible to create multiple panes within a single diagram, and associate each series with a separate pane. Note that series must still have compatible view types, since they are still plotted onto the same diagram.

A typical scenario in which multiple panes are useful is when it is necessary to plot a chart series separately within the same chart. Often, it's also required to use secondary axis with additional panes. As with series, Axes (both primary and secondary) can be plotted on separate panes, with respect to series with which they are associated. Most often, it's required to plot a primary axis through all panes, and create a secondary axis for each pane. The Axis2D.VisibilityInPanes property determines the panes in which an axis should be displayed. To learn more on this, refer to Primary and Secondary Axes.

If scrolling is enabled for your chart's diagram (more on this at Visual Ranges and Whole Ranges ), when it's multi-pane, you can either maintain synchronous scrolling through all the panes, or allow individual scrolling of each pane. This depends on whether series displayed on separate panes have their axes in common. A detailed tutorial on this can be found at How to: Customize the Appearance of a Pane's Scroll Bar (Runtime Sample).

By default, a chart's diagram includes an XYDiagramDefaultPane object, where the chart's general data is shown (with the exception of the legend and Chart Titles). You can access its options via the XYDiagram2D.DefaultPane property, which is shown expanded in the Properties window, in the following image.

If you want to display additional panes within a diagram, you can add them to the collection returned by the XYDiagram2D.Panes property. For more information, refer to Adding Panes.

Expanded See Also

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