WebChartControl.PivotChartingCustomizeXAxisLabels Event
Occurs after automatic layout settings are applied to the X-axis’ labels.
Namespace: DevExpress.XtraCharts.Web
Assembly: DevExpress.XtraCharts.v24.1.Web.dll
NuGet Package: DevExpress.Web.Visualization
Declaration
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 a familiar data source (such as the ASPxPivotGrid) is assigned to the chart’s ASPxDataWebControlBase.DataSourceID property, and the WebChartControl.AutoLayoutSettingsEnabled property is turned on, the AxisLabel.Staggered property is defined automatically, and cannot be customized at design time.
Handle the PivotChartingCustomizeXAxisLabels event, to manually adjust this option (via 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 labels’ direction is made parallel to that of the axis (e.g. 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 labels’ text is affected by the measurement unit specified (e.g., Year, Month, or Day), and the superfluous labels are hidden.
For more information, see Pivot Charting (Integration with a Pivot Grid Control).