Series Titles

• Oct 23, 2024
• 2 minutes to read

This document lists the view types which support series titles, and briefly describes their available properties.

Run Demo: XtraCharts MainDemo — Titles

For series of Pie, Doughnut and Funnel view types, it’s possible to accompany each series with multiple explanatory titles, with HTML and word-wrap support. Series titles can be used to hold either explanatory text for data displayed within the series (e.g. series name), or any additional textual information.

To access the collection of series titles at design time, in the Properties window, expand the SeriesBase.View property, and click the ellipsis button for the SimpleDiagramSeriesViewBase.Titles property.

In the invoked Series Title Collection Editor, you can manage the series titles collection.

The general properties of a series title are:

• The Title.Text property determines the contents of a title. To display the name of the series to which a title belongs, set this property to the “{S}“ or “{s}“ pattern. This may be extremely useful, for example, when creating auto-created series, and it’s required to show their names adjacent to the series.

  For series titles, basic HTML tags are supported, so you can easily apply HTML formatting to a title, by embedding the required tags into their text.

• Via the AlignedTitle.WordWrap property you can force the title’s text to be wrapped in multiple lines, helpful when a series title exceeds the size of the chart. After this property is enabled, you can use the AlignedTitle.MaxLineCount property, to define the maximum number of rows allowed for a title’s text.

  Since series titles are implemented similarly to chart titles, as a detailed tutorial on using word-wrapping, you can refer to How to: Enable Word Wrapping for Chart Titles.

• The AlignedTitle.DXAlignment, DockableTitle.Dock and DockableTitle.Indent properties determine the placement of a title along the corresponding series.
• The TitleBase.DXFont, TitleBase.EnableAntialiasing and TitleBase.TextColor properties determine the appearance of a title’s text.
• Finally, use the TitleBase.Visible property to hide a series title, while maintaining it in the collection.

Note

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.