Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [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]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Collapse]Spreadsheet
   [Expand]Product Information
    Product Structure
    Getting Started
   [Expand]Spreadsheet Document
    Supported Formats
   [Expand]Cell Basics
   [Expand]Spreadsheet Formulas
    Defined Names
    Data Binding
    Data Validation
   [Expand]Data Presentation
    Data Grouping
   [Expand]Pivot Table Overview
   [Expand]Charting Overview
    Printing
    Events
   [Expand]Mail Merge Overview
    Protection
    Find and Replace
   [Collapse]Visual Elements
     Workbook
     Worksheet
    [Expand]Cells and Cell Ranges
     Rows and Columns
     Formulas
     Name Box
     Pictures
     Pop-Up Menus
    [Collapse]Dialogs
      Format Cells Dialog
      Paste Special Dialog
      Edit Hyperlink Dialog
      Symbol Dialog
      Create Table Dialog
      Change Chart Type Dialog
      Find and Replace Dialog
      Encrypt Document Dialog
      Password Dialog
      Protect Workbook Dialog
      Protect Sheet Dialog
      User Permissions Dialog
      Insert Function Dialog
      Function Arguments Dialog
      Name Manager
      New Name Dialog
      Create Names from Selection Dialog
      Subtotal Dialog
      Data Validation Dialog
      Properties Dialog
      Page Setup Dialog
      Header and Footer Dialog
      Create PivotTable Dialog
      Move PivotTable Dialog
      Change PivotTable Data Source Dialog
      PivotTable Field List
      PivotTable Field Settings Dialog
      PivotTable Value Field Settings Dialog
      PivotTable Sort Dialog
      Insert Calculated Field Dialog
      Insert Calculated Item Dialog
      PivotTable Solve Order Dialog
      PivotTable Options Dialog
      New Formatting Rule Dialog
      Conditional Formatting Rules Manager
    Services
   [Expand]Shortcuts
   [Expand]Examples
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap 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]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

PivotTable Value Field Settings Dialog

The Value Field Settings dialog allows end-users to change the calculation and display settings for the PivotTable data fields.

End-users can invoke this dialog by doing the following:

  • Select any cell in the data area;
  • Right-click it and select Value Field Settings... in the context menu...

  • ... or click the Field Settings button. Add the Active Field group to the ribbon to enable this button (see the Getting Started topic for a demonstration on how to provide the SpreadsheetControl with a Ribbon UI).

The Value Field Settings dialog includes two tabs: Summarize Values By and Show Values As.

The Custom Name box at the top of the dialog allows end-users to rename the selected field (PivotDataField.Name).

Clicking the Number Format button invokes the Format Cells dialog, which allows end-users to change the default number format applied to the data field (PivotDataField.NumberFormat).

Expanded Summarize Values By

This tab allows end-users to change the aggregate function used to summarize the data field values (PivotDataField.SummarizeValuesBy). The default functions are Sum (for numeric fields) and Count (for text fields or fields containing blank cells).

Expanded Show Values As

On this tab, end-users can configure how calculation results should be displayed in cells (PivotDataField.ShowValuesAs) by selecting the desired option from the drop-down list. Depending on the selected option, end-users may need to specify either a base field or a base field and its base item to perform a custom calculation.

The table below describes available options that specify how to display summary values within a data field.

Option Description
No Calculation Displays values "as is".
% of Grand Total Displays values as the percentage of the grand total of all values in the PivotTable report.
% of Column Total Displays values in each column as the percentage of the column's total value.
% of Row Total Displays values in each row as the percentage of the row's total value.
% Of Displays values as the percentage of the value of the base item in the base field.
% of Parent Row Total Displays values in each inner row as the percentage of the total of the parent item in the outer row.
% Parent of Column Total Displays values in each inner column as the percentage of the total of the parent item in the outer column.
% of Parent Total Displays values in a data field as the percentage of the value of the parent item in the specified base field.
Difference From Displays values as the difference from the value of the base item in the base field.
% Difference From Displays values as the percentage difference of the value of the base item in the base field.
Running Total in Displays values for successive items in the base field as a running total.
% Running Total in Calculates a running total for successive items in the base field as a percentage of the grand total value.
Rank Smallest to Largest Displays the rank of values for a specific base field, listing the smallest item in the field as 1, and each larger value with a higher rank value.
Rank Largest to Smallest Displays the rank of values for a specific base field, listing the largest item in the field as 1, and each smaller value with a higher rank value.
Index Calculates the relative importance of each summary value by using the following formula:
((value in cell) x (Grand Total of Grand Totals)) / ((Grand Row Total) x (Grand Column Total))

Tip

Use the PivotDataField.SummarizeValuesBy and PivotDataField.ShowValuesAs properties to change calculation settings of a specific data field in code. Refer to the How to: Change the Summary Function for a Data Field and the How to: Apply a Custom Calculation to a Data Field topics for details.

Expanded See Also

How would you rate this topic?​​​​​​​