[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications, and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Collapse]Pivot Grid
   [Expand]Getting Started
   [Expand]Binding to Data
   [Expand]Data Shaping
   [Expand]Data Analysis
   [Expand]Focus and Navigation
   [Expand]Printing and Exporting
   [Expand]Design-Time Features
   [Collapse]UI Elements
     Column Field
     Column Header Area
     Data Area
     Data Field
     Data Field Summary Change Menu
     Data Header Area
     Empty Area
     Expand Button
     Field Header
     Field Header Context Menu
     Field Value
     Field Value Context Menu
     Filter Button and Popup
     Filter Field
     Filter Header Area
     Filter Header Area Separator
     Grand Totals
     Header Area
     Header Area Context Menu
     Filter Panel
     MRU (Most Recently Used) Filter List
     Row Field
     Row Header Area
     Summary Filter Popup Window
   [Expand]End-User Capabilities
   [Expand]Member Tables
  [Expand]Tree List
  [Expand]Gantt Control
  [Expand]Chart Control
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Field Value

The Field values of column fields are displayed along the PivotGridControl's top edge and these represent column headers. The values of row fields are displayed along the control's left edge and represent row headers:

Each Cell in the Data Area displays a summary calculated for a subset of records in the control's underlying data source. All records from this subset have matching values in a column field(s) and row field(s) and these values are identified by column and row headers.


The table below lists the main properties which affect the element's appearance:


The PivotGridAppearancesBase.FieldValue and PivotGridFieldAppearances.Value properties.

Note: the appearance settings are not in effect if the control is painted using the Windows XP, Office2003 or Skin painting scheme (see the PivotGridControl.LookAndFeel property).

Custom Draw Event

The PivotGridControl.CustomDrawFieldValue event.


The PivotCellEventArgsBase<TField, TData, TCustomTotal>.GetFieldValue (see PivotCellEventArgsBase<TField, TData, TCustomTotal>.GetFieldValue) method returns the values of column and row fields. A PivotCellBaseEventArgs object can be accessed via the PivotGridCells.GetCellInfo or PivotGridCells.GetFocusedCellInfo method and when handling cell specific events (PivotGridControl.CellDoubleClick, etc).

The PivotGridFieldBase.ValueFormat property provides the settings used to format field values.

The PivotGridControl.FieldValueDisplayText event allows you to customize the text displayed in a particular field value. If the PivotGridOptionsView.AllowHtmlDrawFieldValues property is set to true, you can assign an HTML string to the PivotFieldDisplayTextEventArgs.DisplayText property. The HTML string may contain images supplied by the PivotGridControl.HtmlImages property.

The PivotGridControl.FieldValueImageIndex event allows you to assign images from an image list to particular field values.

Grouping Mode

The PivotGridFieldBase.GroupInterval property.

Case-Sensitive Grouping

The PivotGridOptionsData.CaseSensitive property.


The PivotGridOptionsCustomization.AllowExpand and PivotGridFieldOptions.AllowExpand properties.

Expanded See Also

Is this topic helpful?​​​​​​​