A newer version of this page is available. Switch to the current version.

AxisLabel.TextPattern Property

Gets or sets a string that formats text for the auto-generated x- or y-axis labels.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v19.1.dll


public string TextPattern { get; set; }

Property Value

Type Description

The string that formats text for axis labels.

The default value is Empty.


The following image shows formatted labels for x- and y-axes:

Axis Patterns

The code below formats label text as in the image above:

AxisLabel axisXLabel = ((XYDiagram)chartControl.Diagram).AxisX.Label;
AxisLabel axisYLabel = ((XYDiagram)chartControl.Diagram).AxisY.Label;

axisXLabel.TextPattern = "{A:dd-MM HH:mm}";
axisYLabel.TextPattern = "{V} °F";

Patterns can contain regular text (displayed as is) and value placeholders in braces. To format numeric and date/time values, you can apply Format Specifiers. Use a colon to separate a placeholder and its format specifier.

The following table contains the available placeholders:

Placeholder Description
Placeholders available for arguments’ axis
{A} Use it to display arguments.
Placeholders available for values’ axis
{V} Use it to display values.
{VP} Use it to display values as a percentage.

To show year quarters for the date-time x-axis labels, use the “{A:q}” pattern.

The following images show how various patterns affect the axis label text:

You can use the Pattern Editor to specify the label text format. To invoke the editor, click the TextPattern property ellipsis button in the Properties window or in the Chart Designer.



This example demonstrates how to customize axis labels’ text pattern. Axis labels use this pattern to provide text representation of axis values’ on which labels are located.

Use the following properties to access the text pattern:

Property Description
Axis2D.Label Gets the settings of axis labels.
Axis3D.Label Gets the settings of axis labels in 3D series.
RadarAxisX.Label Gets the settings of axis labels.
RadarAxisY.Label Gets the settings of axis labels.
AxisLabel.TextPattern Gets or sets a string that formats text for the auto-generated x- or y-axis labels.
using System;
using DevExpress.XtraCharts;

namespace LabelTextPatternSample {
    public partial class Form1 : DevExpress.XtraEditors.XtraForm {
        protected override void OnLoad(EventArgs e) {
            if (chartControl1.Diagram is XYDiagram xyDiagram) {
                xyDiagram.AxisX.Label.TextPattern = "Region: {A}";
                xyDiagram.AxisY.Label.TextPattern = "{VP:P0}";
        public Form1() {
See Also