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.PivotChartingCustomizeLegend Event

Occurs before automatic settings are applied to the legend‘s layout properties.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v24.2.dll

NuGet Package: DevExpress.Reporting.Core

#Declaration

public event CustomizeLegendEventHandler PivotChartingCustomizeLegend

#Event Data

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

Property Description
Legend Gets the chart’s legend.
MaxHorizontalPercentage Specifies the legend‘s maximum horizontal percentage.
MaxVerticalPercentage Specifies the legend‘s maximum vertical percentage.

#Remarks

When an XRPivotGrid is assigned to the chart’s XRChart.DataSource property, and the PivotGridDataSourceOptions.AutoLayoutSettingsEnabled property is enabled, the LegendBase.MaxHorizontalPercentage and LegendBase.MaxVerticalPercentage properties are defined automatically, and cannot be customized at design time.

Handle the PivotChartingCustomizeLegend event, to manually adjust these options (with the CustomizeLegendEventArgs.MaxHorizontalPercentage and CustomizeLegendEventArgs.MaxVerticalPercentage properties). To access the legend, use the CustomizeLegendEventArgs.Legend property.

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

See Also