TitleBase.DXFont Property

Gets or sets the font of the title’s text.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v25.1.dll

NuGet Package: DevExpress.Charts

Declaration

C#

[XtraChartsLocalizableCategory(XtraChartsCategory.Appearance)]
public DXFont DXFont { get; set; }

VB.NET

<XtraChartsLocalizableCategory(XtraChartsCategory.Appearance)>
Public Property DXFont As DXFont

Property Value

Type	Description
DXFont	The font of the title’s text.

Remarks

Important

Use this property instead of Font to specify the font of the title’s text.

Use the Title.Text property to specify the text of the title.

Example

This example demonstrates how to access an axis title at runtime.

Cast your diagram object to the required diagram type to access its axes. Then, you can access the Axis2D.Title property.

View Example: How to Create and Customize an Axis Title

C#

using System;
using System.Drawing;
using System.Windows.Forms;
using DevExpress.Drawing;
using DevExpress.XtraCharts;

namespace AxisTitle {
    public partial class Form1 : Form {
        public Form1() {
            InitializeComponent();
        }
        private void Form1_Load(object sender, EventArgs e) {
        // ...
            // Cast the chart's diagram to the XYDiagram type, to access its axes.
            XYDiagram diagram = chartControl1.Diagram as XYDiagram;

            // Customize the appearance of the X-axis title.
            diagram.AxisX.Title.Visibility = DevExpress.Utils.DefaultBoolean.True;
            diagram.AxisX.Title.Alignment = StringAlignment.Center;
            diagram.AxisX.Title.Text = "<i>X-axis</i> <color=violet>Title</color>";
            diagram.AxisX.Title.TextColor = Color.Red;
            diagram.AxisX.Title.EnableAntialiasing = DevExpress.Utils.DefaultBoolean.True;
            diagram.AxisX.Title.DXFont = new DXFont("Tahoma", 14, DXFontStyle.Bold);

            // Customize the appearance of the Y-axis title.
            diagram.AxisY.Title.Visibility = DevExpress.Utils.DefaultBoolean.True;
            diagram.AxisY.Title.Alignment = StringAlignment.Center;
            diagram.AxisY.Title.Text = "Y-axis Title";
            diagram.AxisY.Title.TextColor = Color.Blue;
            diagram.AxisY.Title.EnableAntialiasing = DevExpress.Utils.DefaultBoolean.True;
            diagram.AxisY.Title.DXFont = new DXFont("Tahoma", 14, DXFontStyle.Bold);

            // Add the chart to the form.
            chartControl1.Dock = DockStyle.Fill;
            this.Controls.Add(chartControl1);
        }
    }
}

VB.NET

Imports System
Imports System.Drawing
Imports System.Windows.Forms
Imports DevExpress.Drawing
Imports DevExpress.XtraCharts

Namespace AxisTitle

    Public Partial Class Form1
        Inherits Form
        ' ...
            ' Hide the legend (if necessary).
            chartControl1.Legend.Visibility = DevExpress.Utils.DefaultBoolean.False
            ' Cast the chart's diagram to the XYDiagram type, to access its axes.
            Dim diagram As XYDiagram = TryCast(chartControl1.Diagram, XYDiagram)
            ' Customize the appearance of the X-axis title.
            diagram.AxisX.Title.Visibility = DevExpress.Utils.DefaultBoolean.True
            diagram.AxisX.Title.Alignment = StringAlignment.Center
            diagram.AxisX.Title.Text = "<i>X-axis</i> <color=violet>Title</color>"
            diagram.AxisX.Title.TextColor = Color.Red
            diagram.AxisX.Title.EnableAntialiasing = DevExpress.Utils.DefaultBoolean.True
            diagram.AxisX.Title.DXFont = New DXFont("Tahoma", 14, DXFontStyle.Bold)
            ' Customize the appearance of the Y-axis title.
            diagram.AxisY.Title.Visibility = DevExpress.Utils.DefaultBoolean.True
            diagram.AxisY.Title.Alignment = StringAlignment.Center
            diagram.AxisY.Title.Text = "Y-axis Title"
            diagram.AxisY.Title.TextColor = Color.Blue
            diagram.AxisY.Title.EnableAntialiasing = DevExpress.Utils.DefaultBoolean.True
            diagram.AxisY.Title.DXFont = New DXFont("Tahoma", 14, DXFontStyle.Bold)
            ' Add the chart to the form.
            chartControl1.Dock = DockStyle.Fill
            Me.Controls.Add(chartControl1)
        End Sub
    End Class
End Namespace

Related GitHub Examples

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

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#

winforms-chart-create-and-customize-an-axis-title/CS/AxisTitle/Form1.cs#L39

diagram.AxisX.Title.EnableAntialiasing = DevExpress.Utils.DefaultBoolean.True;
diagram.AxisX.Title.DXFont = new DXFont("Tahoma", 14, DXFontStyle.Bold);

winforms-chart-create-and-customize-chart-titles/CS/Form1.cs#L35

chartTitle1.EnableAntialiasing = DevExpress.Utils.DefaultBoolean.True;
chartTitle1.DXFont = new DXFont("Tahoma", 14, DXFontStyle.Bold);
chartTitle1.TextColor = Color.Red;

VB.NET

winforms-chart-create-and-customize-an-axis-title/VB/AxisTitle/Form1.vb#L38

diagram.AxisX.Title.EnableAntialiasing = DevExpress.Utils.DefaultBoolean.True
diagram.AxisX.Title.DXFont = New DXFont("Tahoma", 14, DXFontStyle.Bold)
' Customize the appearance of the Y-axis title.

winforms-chart-create-and-customize-a-constant-line/VB/ConstLines/Form1.vb#L47

constantLine1.Title.EnableAntialiasing = DevExpress.Utils.DefaultBoolean.False
constantLine1.Title.DXFont = New DXFont("Tahoma", 14, DXFontStyle.Bold)
constantLine1.Title.ShowBelowLine = True

winforms-chart-create-and-customize-chart-titles/VB/Form1.vb#L33

chartTitle1.EnableAntialiasing = DevExpress.Utils.DefaultBoolean.True
chartTitle1.DXFont = New DXFont("Tahoma", 14, DXFontStyle.Bold)
chartTitle1.TextColor = Color.Red