AxisTitle Class
Defines the common settings of an axis’s title.
Namespace: DevExpress.XtraCharts
Assembly: DevExpress.XtraCharts.v24.1.dll
NuGet Package: DevExpress.Charts
Declaration
[TypeConverter(typeof(AxisTitleTypeConverter))]
public abstract class AxisTitle :
Title,
ITextPropertiesProvider,
IHitTest,
ISupportTextAntialiasing,
ISupportVisibilityControlElementRelated API Members
The following members return AxisTitle objects:
Remarks
The AxisTitle class declares properties that define the common appearance settings of a title which is displayed by a particular axis.
Properties exposed via the AxisTitle class allow you to customize common title attributes, such as:
- the axis title’s text (Title.Text),
- the color and font settings of the title’s text (TitleBase.TextColor and TitleBase.Font),
- apply antialising (smoothing) to the title’s text (TitleBase.Antialiasing),
- the alignment of the axis title (AxisTitle.Alignment),
- the visibility of the axis title (TitleBase.Visible).
At the same time the AxisTitle class represents the base class for the AxisTitleX and AxisTitleY classes that respectively define title settings for axes of X and Y types. The properties and methods which are defined by the AxisTitle class specify the base axis title settings and are common to all axis titles. The only difference in axis titles of the AxisTitleX and AxisTitleY types is in the initialization of the Title.Text property’s default value.
For more information, refer to Axis Titles.
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.
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);
}
}
}