Back to Devexpress

ChartTitleCollection Class

corelibraries-devexpress-dot-xtracharts-c7c2a68c.md

latest4.7 KB
Original Source

ChartTitleCollection Class

Represents a collection of chart titles within a chart control.

Namespace : DevExpress.XtraCharts

Assembly : DevExpress.XtraCharts.v25.2.dll

NuGet Package : DevExpress.Charts

Declaration

csharp
public class ChartTitleCollection :
    DockableTitleCollectionBase
vb
Public Class ChartTitleCollection
    Inherits DockableTitleCollectionBase

The following members return ChartTitleCollection objects:

LibraryRelated API Members
WinForms ControlsChartControl.Titles
ASP.NET MVC ExtensionsChartControlSettings.Titles
ASP.NET Web Forms ControlsWebChartControl.Titles
.NET Reporting ToolsXRChart.Titles

Remarks

The ChartTitleCollection class implements all the chart title collection functionality used to manipulate chart titles within a chart control. Members available via the ChartTitleCollection class allow you to add, delete, access individual chart titles and perform other common collection management tasks. The collection of chart titles can be accessed via the ChartControl.Titles property of a chart control.

For more information, refer to Chart Titles.

Example

This example demonstrates how chart titles can be accessed and customized at runtime.

csharp
// Create chart titles.
ChartTitle chartTitle1 = new ChartTitle();
ChartTitle chartTitle2 = new ChartTitle();

// Define the text for the titles.
chartTitle1.Text = "<i>Basic</i> <b>HTML</b> <u>is</u> <color=blue>supported</color>.";
chartTitle2.Text = "The capability to word-wrap is available for chart titles.";

chartTitle2.WordWrap = true;
chartTitle2.MaxLineCount = 2;

// Define the alignment of the titles.
chartTitle1.Alignment = StringAlignment.Center;
chartTitle2.Alignment = StringAlignment.Near;

// Place the titles where it's required.
chartTitle1.Dock = ChartTitleDockStyle.Top;
chartTitle2.Dock = ChartTitleDockStyle.Bottom;

// Customize a title's appearance.
chartTitle1.Antialiasing = true;
chartTitle1.Font = new Font("Tahoma", 14, FontStyle.Bold);
chartTitle1.TextColor = Color.Red;
chartTitle1.Indent = 10;

// Add the titles to the chart.
chartControl1.Titles.AddRange(new ChartTitle[] {
chartTitle1,
chartTitle2});
vb
' Create chart titles.
Dim chartTitle1 As New ChartTitle()
Dim chartTitle2 As New ChartTitle()

' Define the text for the titles.
chartTitle1.Text = "<i>Basic</i> <b>HTML</b> <u>is</u> <color=blue>supported</color>."
chartTitle2.Text = "The capability to word-wrap is available for chart titles."

chartTitle2.WordWrap = True
chartTitle2.MaxLineCount = 2

' Define the alignment of the titles.
chartTitle1.Alignment = StringAlignment.Center
chartTitle2.Alignment = StringAlignment.Near

' Place the titles where it's required.
chartTitle1.Dock = ChartTitleDockStyle.Top
chartTitle2.Dock = ChartTitleDockStyle.Bottom

' Customize a title's appearance.
chartTitle1.Antialiasing = True
chartTitle1.Font = New Font("Tahoma", 14, FontStyle.Bold)
chartTitle1.TextColor = Color.Red
chartTitle1.Indent = 10

' Add the titles to the chart.
chartControl1.Titles.AddRange(New ChartTitle() { chartTitle1, chartTitle2})

Inheritance

Object CollectionBase ChartCollectionBase DockableTitleCollectionBase ChartTitleCollection

See Also

ChartTitleCollection Members

Titles

Chart Titles

DevExpress.XtraCharts Namespace