PivotGridControl.CustomValueAppearance Event
Allows you to specify brushes used to paint field value cells.
Namespace: DevExpress.Xpf.PivotGrid
Assembly: DevExpress.Xpf.PivotGrid.v24.2.dll
NuGet Package: DevExpress.Wpf.PivotGrid
#Declaration
public event PivotCustomValueAppearanceEventHandler CustomValueAppearance
#Event Data
The CustomValueAppearance event's data class is PivotCustomValueAppearanceEventArgs. The following properties provide information specific to this event:
Property | Description |
---|---|
Background | Gets or sets the brush used to paint the background of the processed field value cell. |
Custom |
Gets the custom total which the currently processed column/row header corresponds to.
Inherited from Pivot |
Data |
Gets the data field that identifies the processed value.
Inherited from Pivot |
Field |
Gets the field being processed.
Inherited from Pivot |
Field |
Gets the field’s position among the visible fields within the header area.
Inherited from Pivot |
Foreground | Gets or sets the brush used to paint the foreground of the processed field value cell. |
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 |
Is |
Gets whether the processed field value is collapsed.
Inherited from Pivot |
Is |
Gets whether the field is displayed within the Column Header Area.
Inherited from Pivot |
Is |
Gets or sets whether the pivot grid is being exported (or printed). |
Is |
Gets whether the current header corresponds to the “Others” row/column.
Inherited from Pivot |
Max |
Gets the maximum row index (for row fields) or column index (for column fields) that corresponds to the field value currently being processed.
Inherited from Pivot |
Min |
Gets the minimum row index (for row fields) or column index (for column fields) that corresponds to the field value currently being processed.
Inherited from Pivot |
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 |
Selected |
Gets whether the processed field value is selected.
Inherited from Pivot |
Source |
Gets or sets a reference to the object that raised the event.
Inherited from Routed |
Value |
Gets the column field or row field value which the currently processed column/row header corresponds to.
Inherited from Pivot |
Value |
Gets the type of the currently processed column/row header.
Inherited from Pivot |
The event data class exposes the following methods:
Method | Description |
---|---|
Change |
Changes the expanded state of the field value currently being processed.
Inherited from Pivot |
Create |
Returns a list of records associated with the field value currently being processed.
Inherited from Pivot |
Create |
Returns a list of records used to calculate a summary value for the specified cell. Allows you to specify the columns, and limit the number of records 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, and limit the number of records to be returned.
Inherited from Pivot |
Get |
Returns a value displayed in the specified cell.
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 parent field |
Get |
Returns the value of a specific parent field corresponding to the field value currently being processed.
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 |
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 CustomValueAppearance event is fired for each field value cell after the PivotGridControl layout changes.
This event allows you to specify brushes used to paint the background and foreground of the processed field value cell. To do this, use the event parameter’s PivotCustomValueAppearanceEventArgs.Background and PivotCustomValueAppearanceEventArgs.Foreground properties, respectively.
Use the PivotCustomValueAppearanceEventArgs.IsExporting property to obtain whether the pivot grid is being exported (or printed). If the PivotCustomValueAppearanceEventArgs.IsExporting property returns true, brushes assigned to the PivotCustomValueAppearanceEventArgs.Background and PivotCustomValueAppearanceEventArgs.Foreground properties will affect the processed field value cell’s export (or print) appearance. Otherwise, these brushes will affect the field value cell’s display appearance.
To specify brushes used to paint summary cells, handle the PivotGridControl.CustomCellAppearance event.