PivotGridControl.CustomCellValue Event
Allows you to replace cell values with values calculated in the event handler.
Namespace: DevExpress.Xpf.PivotGrid
Assembly: DevExpress.Xpf.PivotGrid.v24.2.dll
NuGet Package: DevExpress.Wpf.PivotGrid
#Declaration
public event PivotCellValueEventHandler CustomCellValue
#Event Data
The CustomCellValue event's data class is PivotCellValueEventArgs. The following properties provide information specific to this event:
Property | Description |
---|---|
Column |
Gets the custom total to which the processed cell’s column corresponds.
Inherited from Pivot |
Column |
Gets the innermost column field which corresponds to the processed cell.
Inherited from Pivot |
Column |
This member supports the internal infrastructure and is not intended to be used directly from your code.
Inherited from Pivot |
Column |
Gets the visual index of the column that contains the processed cell.
Inherited from Pivot |
Column |
Gets the type of the cell’s column header.
Inherited from Pivot |
Data |
Gets the data field which identifies the column where the processed cell resides.
Inherited from Pivot |
Display |
Gets the display text of the cell currently being processed.
Inherited from Pivot |
Focused |
Gets whether the processed cell is the focused cell.
Inherited from Pivot |
Handled |
Gets or sets a value that indicates the present state of the event handling for a routed event as it travels the route.
Inherited from Routed |
Original |
Gets the original reporting source as determined by pure hit testing, before any possible Source adjustment by a parent class.
Inherited from Routed |
Routed |
Gets or sets the Routed |
Row |
Gets the custom total to which the processed cell’s row corresponds.
Inherited from Pivot |
Row |
Gets the innermost row field which corresponds to the processed cell.
Inherited from Pivot |
Row |
This member supports the internal infrastructure and is not intended to be used directly from your code.
Inherited from Pivot |
Row |
Gets the visual index of the row that contains the processed cell.
Inherited from Pivot |
Row |
Gets the type of the cell’s row header.
Inherited from Pivot |
Selected |
Gets whether the processed cell is selected.
Inherited from Pivot |
Source |
Gets or sets a reference to the object that raised the event.
Inherited from Routed |
Summary |
Gets the type of summary calculated in the current cell.
Inherited from Pivot |
Summary |
Gets the summary value currently being processed.
Inherited from Pivot |
Value | Gets or sets the processed cell’s value. |
The event data class exposes the following methods:
Method | Description |
---|---|
Create |
Returns a list of records used to calculate a value for the current cell.
Inherited from Pivot |
Create |
Returns a list of records used to calculate a summary value for the current cell. Allows you to specify the columns to return.
Inherited from Pivot |
Create |
Returns a list of records used to calculate a summary value for the current cell. Allows you to specify the columns and limit the number of records to return.
Inherited from Pivot |
Create |
Obsolete. In OLAP mode, returns a list of records used to calculate a summary value for the current cell. Allows you to specify the columns to be returned.
Inherited from Pivot |
Create |
Obsolete. In OLAP mode, returns a list of records used to calculate a summary value for the current cell. Allows you to specify the columns and limit the number of records to be returned.
Inherited from Pivot |
Create |
Obsolete. In server mode, returns a list of records used to calculate a summary value for the current cell. Allows you to specify the columns to be returned.
Inherited from Pivot |
Create |
Obsolete. In server mode, returns a list of records used to calculate a summary value for the current cell. Allows you to specify the columns and limit the number of records to be returned.
Inherited from Pivot |
Create |
Returns a summary data source.
Inherited from Pivot |
Get |
Returns a cell value calculated for the current column and row field values, against the specified data field.
Inherited from Pivot |
Get |
Returns a cell value by the column and row indexes.
Inherited from Pivot |
Get |
Returns a cell value calculated for the specified column and row field values, against the specified data field.
Inherited from Pivot |
Get |
Returns an array of column fields which correspond to the processed cell.
Inherited from Pivot |
Get |
Returns a Column Grand Total value calculated for the current row field values, against the specified data field.
Inherited from Pivot |
Get |
Returns a Column Grand Total value calculated for the specified row field values, against the specified data field.
Inherited from Pivot |
Get |
Returns the specified column or row field’s value for the cell, addressed by its zero-based index in the Data Area.
Inherited from Pivot |
Get |
Returns the value of the specified column or row field which identifies the column/row in which the processed cell resides.
Inherited from Pivot |
Get |
Gets the Grand Total for the specified field.
Inherited from Pivot |
Get |
Returns the value of the cell in the same row but in the next column.
Inherited from Pivot |
Get |
Returns the value of the cell in the next row.
Inherited from Pivot |
Get |
Returns the value of the cell in the same row, but in the previous column.
Inherited from Pivot |
Get |
Returns the value of the cell in the previous row.
Inherited from Pivot |
Get |
Returns an array of row fields that correspond to the processed cell.
Inherited from Pivot |
Get |
Returns a Row Grand Total value calculated for the current column field values, against the specified data field.
Inherited from Pivot |
Get |
Returns a Row Grand Total value calculated for the specified column field values, against the specified data field.
Inherited from Pivot |
Invoke |
When overridden in a derived class, provides a way to invoke event handlers in a type-specific way, which can increase efficiency over the base implementation.
Inherited from Routed |
Is |
Indicates whether the specified field’s value that represents a row or column header of the processed cell is expanded.
Inherited from Pivot |
Is |
Gets whether the value of the specified column or row field can be retrieved for the current cell by the Pivot |
Is |
Indicates whether the processed data cell resides within the “Others” row/column when the Top N Value feature is enabled.
Inherited from Pivot |
On |
When overridden in a derived class, provides a notification callback entry point whenever the value of the Source property of an instance changes.
Inherited from Routed |
#Remarks
The CustomCellValue
event fires after all control calculations when cell values are filtered, grouped, and sorted. Handle the event to replace the calculated cell values with custom values. You can create custom calculations in the event handler and assign the result to the e.Value property. Use the event parameter’s SummaryValue property to obtain the summary value calculated for the cell.
Use the following event parameter’s properties to obtain the fields that correspond to the processed cell:
Use the following event parameter’s properties to obtain the visual indices of the column and row that contain the cell:
You can also enable custom display text in the PivotGridControl.CustomCellDisplayText event that is raised after the CustomCellValue event.
Note
The Pivot Grid uses values from the Custom
and Custom
events only to represent data. The control does not take these values into account when sorting, filtering, or calculating data because these operations have already completed when the events occur.
#Example: Hide Column Totals
This example demonstrates how to handle the CustomCellValue
event to hide the Discount field grand totals.
private void PivotGridControl1_CustomCellValue(object sender,PivotCellValueEventArgs e) {
if (e.ColumnValueType == FieldValueType.GrandTotal
&& e.DataField == fieldDiscount)
e.Value = null;
}
<dxpg:PivotGridControl DataProcessingEngine="Optimized"
Name="pivotGridControl1"
CustomCellValue="PivotGridControl1_CustomCellValue">
<dxpg:PivotGridControl.Fields>
<!-- ... -->
<dxpg:PivotGridField Name="fieldDiscount" Area="DataArea" CellFormat="p">
<dxpg:PivotGridField.DataBinding>
<dxpg:DataSourceColumnBinding ColumnName="Discount"/>
</dxpg:PivotGridField.DataBinding>
</dxpg:PivotGridField>
<!-- ... -->
</dxpg:PivotGridControl.Fields>
</dxpg:PivotGridControl>
#Related GitHub Examples
The following code snippet (auto-collected from DevExpress Examples) contains a reference to the CustomCellValue event.
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.