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

XRPivotGrid.CustomCellDisplayText Event

Enables custom display text to be provided for the cells displayed within the Data Area.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v24.2.dll

NuGet Package: DevExpress.Reporting.Core

#Declaration

public event EventHandler<PivotCellDisplayTextEventArgs> CustomCellDisplayText

#Event Data

The CustomCellDisplayText event's data class is DevExpress.XtraReports.UI.PivotGrid.PivotCellDisplayTextEventArgs.

#Remarks

The CustomCellDisplayText event provides the ability to customize the display text within data cells (the cells which are displayed within the Data Area). A data cell displays a summary value which is calculated against a specific Data Field. This field is identified by the event’s DataField parameter. The current value and its formatted text representation is specified by the event’s Value and DisplayText parameters.

It’s possible to specify the settings used to format data cells via the PivotGridFieldBase.CellFormat, PivotGridFieldBase.TotalCellFormat and PivotGridFieldBase.GrandTotalCellFormat properties of data fields. So, handle the CustomCellDisplayText event if these format properties do not suit your needs.

Use the XRPivotGrid.FieldValueDisplayText event or PivotGridFieldBase.ValueFormat property to customize the display text used to represent field values.

See Also