ChartTitle Class

Represents an individual chart title.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v18.1.dll

Declaration

C#

[TypeConverter(typeof(ChartTitleTypeConverter))]
public class ChartTitle :
    DockableTitle

VB.NET

<TypeConverter(GetType(ChartTitleTypeConverter))>
Public Class ChartTitle
    Inherits DockableTitle

Related API Members

The following members accept/return ChartTitle objects:

• ChartHitInfo.ChartTitle
• ChartTitleCollection.Item[Int32]

Remarks

The ChartTitle class implements the functionality of an individual chart title in a chart control.

A chart control’s titles are stored within the ChartControl.Titles collection, represented by an instance of the ChartTitleCollection class. This collection provides standard means for manipulating its items such as adding, removing and accessing them. A particular chart title is available via the ChartTitleCollection.Item property of the collection using indexer notation.

For more information, refer to Chart Titles.

Example

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

C#

// 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.NET

' 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})

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ChartTitle class.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-add-titles-to-a-chart-e1375/CS/Form1.cs#L15

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

how-to-change-the-appearance-palette-of-the-webchartcontrol-e1166/CS/WebApplication1/Default.aspx.cs#L84

((WebChartControl)sender).Titles.Clear();
ChartTitle ct = new ChartTitle();
ct.Text = s[1];

how-to-create-a-point-chart-e1209/CS/Series_PointChart/Form1.cs#L49

// Add a title to the chart (if necessary).
pointChart.Titles.Add(new ChartTitle());
pointChart.Titles[0].Text = "A Point Chart";

how-to-create-a-nested-doughnut-chart-e5221/CS/NestedDoughnut/Form1.cs#L62

// Add a title to the chart.
ChartTitle chartTitle1 = new ChartTitle();
chartTitle1.Text = "Nested Doughnut Chart";

how-to-create-a-full-stacked-line-chart-t124058/CS/FullStackedLineChart/Form1.cs#L46

// Add a title to the chart (if necessary).
fullStackedLineChart.Titles.Add(new ChartTitle());
fullStackedLineChart.Titles[0].Text = "Full Stacked Line Chart";

VB.NET

how-to-add-titles-to-a-chart-e1375/VB/Form1.vb#L17

' Create chart titles.
Dim chartTitle1 As New ChartTitle()
Dim chartTitle2 As New ChartTitle()

how-to-change-the-appearance-palette-of-the-webchartcontrol-e1166/VB/WebApplication1/Default.aspx.vb#L76

CType(sender, WebChartControl).Titles.Clear()
Dim ct As New ChartTitle()
ct.Text = s(1)

how-to-create-a-point-chart-e1209/VB/Series_PointChart/Form1.vb#L51

' Add a title to the chart (if necessary).
pointChart.Titles.Add(New ChartTitle())
pointChart.Titles(0).Text = "A Point Chart"

how-to-create-a-nested-doughnut-chart-e5221/VB/NestedDoughnut/Form1.vb#L64

' Add a title to the chart.
Dim chartTitle1 As New ChartTitle()
chartTitle1.Text = "Nested Doughnut Chart"

how-to-create-a-full-stacked-line-chart-t124058/VB/FullStackedLineChart/Form1.vb#L48

' Add a title to the chart (if necessary).
fullStackedLineChart.Titles.Add(New ChartTitle())
fullStackedLineChart.Titles(0).Text = "Full Stacked Line Chart"

Inheritance

Object

ChartElement

TitleBase

Title

MultilineTitle

DockableTitle

ChartTitle