[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)

Pane Title

You can show a title under the pane to distinguish between multiple panes. End users can use the expand button next to the title to hide or show panes.

This document explains how to:

Expanded Add a Pane Title

Each pane can have one title. To display the title, set its Visibility property to True. The title is shown with a button that allows you to collapse and expand a pane if the XYDiagramPaneBase.RuntimeCollapse (or XYDiagram2D.RuntimePaneCollapse) option is enabled. If an end user collapses a pane, other panes' sizes are recalculated to occupy all the available space. Set RuntimeCollapse to false to hide the title expand button and prevent end users from collapsing panes.

To specify the title's content, use the Text property. Its default value is the pane's Name property value.


The Chart Control can hide its elements if there is insufficient space to display them. Elements are hidden in the following order:

  1. Legends
  2. Axis Titles
  3. Series Titles
  4. Pane Titles
  5. Axes
  6. Chart Title
  7. Breadcrumbs

To make the Chart Control always display its elements, disable the ChartControl.AutoLayout property.

Add a Title at Design Time

You can configure a pane title's options in the Properties window:

Add a Title in Code

The following code specifies a pane's title text and visibility:

The code above uses the following API members:

Member Description
XYDiagramPaneBase.Title Returns the pane title settings.
Title.Text Gets or sets title content.
PaneTitle.Visibility Specifies whether the title is visible.

Expanded Align a Pane Title

You can align a pane title to the pane's top edge and configure indents between the title and other chart elements.

The following code shows how to customize the alignment and margins:

Use the following API members to align pane titles:

Member Description
PaneTitle.Alignment Specifies the title's alignment.
PaneTitle.Margins Specifies the title's outer indents.
RectangleIndents.Left Gets or sets the title's left margin.
RectangleIndents.Top Gets or sets the title's upper margin.
RectangleIndents.Right Specifies the title's right margin.
RectangleIndents.Bottom Gets or sets the title's lower margin.

Expanded Customize a Title's Text Appearance

You can use the TitleBase.Font property to configure font parameters, and the TitleBase.TextColor property to change the title's color.

The following sample demonstrates how to change a title's font and color:

The code above uses the following properties:

Property Description
TitleBase.Font Specifies the title's font.
TitleBase.TextColor Defines the title's text color.

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