[Expand]General Information
[Collapse]WinForms Controls
 [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
  [Collapse]Chart Control
   [Expand]Getting Started
    [Expand]Charting Basics
    [Expand]Professional Charting
    [Expand]Series Views
    [Collapse]Chart Elements
      Chart Titles
   [Expand]Providing Data
   [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]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]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Chart Titles

This document describes how chart titles can be created and customized, and illustrates their general functionality.

Chart titles allow you to accompany your chart with text headers and explanations with HTML support, and no limitations on the size and quantity of titles.

Note that if a chart title's length exceeds the size of the chart, you can force the title's text to be wrapped in multiple lines using the DevExpress.XtraCharts.AlignableTitle.WordWrap property.

To access the chart title collection at design time, select the chart control, and in the Properties window, locate the ChartControl.Titles property. Click its ellipsis button, and the Chart Title Collection Editor will appear.

In this dialog, use the Add button to create chart titles. After a title is created, you can customize its appearance and behavior using the available properties briefly described below.

  • A title's text is determined by the Title.Text property. You can apply HTML formatting to your chart's titles, by using standard HTML tags. To learn more on HTML support, refer to HTML Text Formatting.

  • The appearance of title text can be customized with the TitleBase.Font, TitleBase.Antialiasing and TitleBase.TextColor properties. Note that the color defined with title HTML tags <color></color> has priority over the title's TitleBase.TextColor property's setting.

  • Placement of titles within a chart is determined by their DevExpress.XtraCharts.AlignableTitle.Alignment and DockableTitle.Dock properties.

  • To define the spacing around a title (in pixels), define its DockableTitle.Indent property.

  • To enable automatic word wrapping for lengthy chart titles, use the DevExpress.XtraCharts.AlignableTitle.WordWrap property.

    After you enable this property, the DevExpress.XtraCharts.AlignableTitle.MaxLineCount property comes into effect, which allows you to determine the limit for new lines appearing when a title's text is wrapped. Note that if a title's length exceeds this limit, the last line of text will be cut off by an ellipsis.

    If required, you can set the DevExpress.XtraCharts.AlignableTitle.MaxLineCount property to 0, which will wrap title completely.

  • To hide a title while maintaining it in the collection, disable its TitleBase.Visible property.

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