Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

XRChart.PivotChartingCustomizeXAxisLabels Event

Occurs after automatic layout settings are applied to the X-axis’ labels.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v24.2.dll

NuGet Package: DevExpress.Reporting.Core

#Declaration

public event CustomizeXAxisLabelsEventHandler PivotChartingCustomizeXAxisLabels

#Event Data

The PivotChartingCustomizeXAxisLabels event's data class is CustomizeXAxisLabelsEventArgs. The following properties provide information specific to this event:

Property Description
Axis Gets the X-axis, whose labels are being customized.
Staggered Specifies whether the X-axis labels should be staggered.

#Remarks

When an XRPivotGrid is assigned to the chart’s XRChart.DataSource property and the PivotGridDataSourceOptions.AutoLayoutSettingsEnabled property is enabled, the AxisLabel.Staggered property is defined automatically, and cannot be customized at design time.

Handle the PivotChartingCustomizeXAxisLabels event, to manually adjust this option (with the CustomizeXAxisLabelsEventArgs.Staggered property). To access the X-axis, use the CustomizeXAxisLabelsEventArgs.Axis property.

Note

The X-axis’ labels are staggered if the axis scale type is Qualitative or DateTime (except for Year). And, the label direction is made parallel to that of the axis (i.e., the AxisLabel.Angle is 0 if the diagram is not rotated, and the AxisLabel.Angle is 90 when the diagram is rotated). In addition, the label text is affected by the measurement unit specified (e.g., Year, Month, or Day), and the superfluous labels are hidden.

To learn more, see Pivot Charting (Integration with a Pivot Grid Control).

See Also