Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  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]Pivot Grid
  [Expand]Tree List
  [Collapse]Chart Control
   [Expand]Getting Started
   [Collapse]Fundamentals
    [Expand]Charting Basics
    [Expand]Professional Charting
    [Expand]Series Views
    [Collapse]Chart Elements
     [Expand]Series
     [Collapse]Diagram
      [Expand]Diagram Types
      [Expand]Axes
      [Collapse]Panes
        Adding Panes
        Panes Alignment
        Panes Appearance
      Chart Titles
     [Expand]Legends
     [Expand]Annotations
   [Expand]Providing Data
   [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]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]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Panes

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

How would you rate this topic?​​​​​​​