[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
   Reporting
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Expand]Charts Suite
  [Collapse]Pivot Grid
   [Expand]Getting Started
   [Expand]Fundamentals
   [Expand]Binding to Data
   [Expand]Data Shaping
   [Expand]Data Analysis
   [Collapse]Layout
     Field Groups
     Data Cell Layout
     Field Location and Order
    [Collapse]Customization Form
      Customization Form Overview
      Customization Form Styles
      Standalone Customization Control
      User Folders
     Best Fit
     Standalone Field Header Areas
     Group Value
     Save and Restore Layout
   [Expand]Printing and Exporting
   [Expand]End-User Interaction
   [Expand]Appearance
   [Expand]MVVM Enhancements
   [Expand]UI Elements
   [Expand]End-User Capabilities
   [Expand]Examples
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Printing-Exporting
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Gantt Control
  [Expand]Diagram Control
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
 [Expand]Localization
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Customization Form Styles

The Customization Form can be painted in two styles: Simple and Excel 2007. A style defines the Customization Form layout and the capabilities available for end-users.

Use the PivotGridControl.FieldListStyle property to specify the required style.

Expanded Simple Style

A simple-style Customization Form displays hidden fields by default.

End users can hide visible fields by dragging and dropping them onto the Customization Form, and return hidden fields to the pivot report by dropping them onto appropriate Header Areas. When end users move fields to the Customization Form, the field's visibility is changed, but the field's area remains unchanged.

If the PivotGridControl.FieldListIncludeVisibleFields property (PivotFieldListControl.IncludeVisibleFields for standalone Customization Forms) is set to true, a simple-style Customization Form displays visible fields together with hidden ones. In this instance, a check box is shown near each field allowing you to show or hide this field.

Expanded Excel 2007 Style

An Excel-style Customization Form contains a section where hidden fields are displayed and four more sections that display visible fields located in the Column, Data, Filter and Row areas.

Similarly to a simple-style Customization Form, end users can hide visible fields by dragging and dropping them into the Hidden Fields section and return hidden fields to the pivot report by dropping them onto appropriate Header Areas.

The following are additional capabilities provided exclusively by the Excel-style Customization Form.

  • Move a field to a specific area by dragging its header between the Customization Form's area boxes.
  • Delay layout updates. First, check the Defer Layout Update check box, then drag fields between the areas and click the Update button to apply changes.
  • Sort and filter data. You can toggle the sort order of fields by clicking their headers in the Customization Form and invoke filter popup windows via the filter buttons.

    Use the PivotGridControl.AllowSortInFieldList and PivotGridControl.AllowFilterInFieldList properties to specify whether end users are allowed to perform sorting and filtering in the Customization Form.

End-users can change the Customization Form layout via a popup menu.

You can prevent end users from selecting particular layouts by listing all the allowed layouts via the PivotGridControl.FieldListAllowedLayouts property.

To specify a layout in code, use the PivotGridControl.FieldListLayout property.

If the PivotGridControl.FieldListIncludeVisibleFields property (PivotExcelFieldListControl.IncludeVisibleFields for standalone Customization Forms) is set to true, a simple-style Hidden Fields section displays visible fields together with hidden ones. In this instance, a check box is shown near each field allowing you to show or hide this field.

Expanded See Also

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