corelibraries-devexpress-dot-xtracharts-dot-axislabel-0633002d.md
Gets or sets a value indicating whether axis labels/axis custom labels are positioned in staggered order.
Namespace : DevExpress.XtraCharts
Assembly : DevExpress.XtraCharts.v25.2.dll
NuGet Package : DevExpress.Charts
[XtraChartsLocalizableCategory(XtraChartsCategory.Layout)]
public bool Staggered { get; set; }
<XtraChartsLocalizableCategory(XtraChartsCategory.Layout)>
Public Property Staggered As Boolean
| Type | Description |
|---|---|
| Boolean |
true if axis labels are positioned in staggered order; false if labels are displayed in a single line.
|
Use the Staggered property to control how axis labels are displayed relative to the corresponding axis. If this property is set to false , axis labels are displayed on a single line along the axis. When axis labels contain long texts and overlap, set the Staggered property to true in order to stagger axis labels.
In addition, it is possible to use another approach to avoid overlapping for axis labels, e.g. rotate the labels by using the AxisLabel.Angle property. In this case, it’s also recommended to enable the TitleBase.EnableAntialiasing property, to draw the labels’ text smoothly.
This example demonstrates how to access and customize axis labels.
// Cast the chart's diagram to the XYDiagram type, to access its axes.
XYDiagram diagram = (XYDiagram)chartControl1.Diagram;
// Customize the X-axis labels' appearance.
diagram.AxisX.Label.Angle = -30;
diagram.AxisX.Label.Staggered = true;
diagram.AxisX.Label.TextColor = Color.Bisque;
// As opposed to the above properties, the following ones
// will not affect custom labels, if they exist for the axes.
diagram.AxisX.Label.BeginText = "Some prefix ";
diagram.AxisX.Label.EndText = " some postfix.";
' Cast the chart's diagram to the XYDiagram type, to access its axes.
Dim diagram As XYDiagram = CType(chartControl1.Diagram, XYDiagram)
' Customize the X-axis labels' appearance.
diagram.AxisX.Label.Angle = - 30
diagram.AxisX.Label.Staggered = True
diagram.AxisX.Label.TextColor = Color.Bisque
' As opposed to the above properties, the following ones
' will not affect custom labels, if they exist for the axes.
diagram.AxisX.Label.BeginText = "Some prefix "
diagram.AxisX.Label.EndText = " some postfix."
The following code snippet (auto-collected from DevExpress Examples) contains a reference to the Staggered 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.
winforms-heatmap-bind-to-data-source/CS/Form1.cs#L65
heatmap.AxisX.Title.Visibility = DevExpress.Utils.DefaultBoolean.True;
heatmap.AxisX.Label.Staggered = false;
heatmap.AxisX.Label.ResolveOverlappingOptions.AllowStagger = false;
winforms-heatmap-bind-to-data-source/VB/Form1.vb#L43
Me.heatmap.AxisX.Title.Visibility = DevExpress.Utils.DefaultBoolean.[True]
Me.heatmap.AxisX.Label.Staggered = False
Me.heatmap.AxisX.Label.ResolveOverlappingOptions.AllowStagger = False
See Also