[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]Property Grid
  [Collapse]Pivot Grid
   [Expand]Getting Started
   [Expand]Fundamentals
   [Expand]Binding to Data
   [Expand]Data Shaping
   [Expand]Data Analysis
   [Collapse]Layout
     Field Location and Order
     Data Cell Layout
     Field Groups
    [Collapse]Customization Form
      Customization Form Overview
      Customization Form Styles
      User Folders
     Best Fit
     Save and Restore Layout
   [Expand]Focus and Navigation
   [Expand]Printing and Exporting
   [Expand]Appearance
   [Expand]Design-Time Features
   [Expand]Miscellaneous
   [Expand]UI Elements
   [Expand]End-User Capabilities
   [Expand]Examples
   [Expand]Member Tables
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [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]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]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 style defines the Customization Form layout and the capabilities available for end users. To specify the required style, use the PivotGridOptionsCustomization.CustomizationFormStyle property.

The Customization Form can be painted in two styles: Simple and Excel 2007.

Expanded Simple Style

A simple-style Customization Form displays hidden fields.

End users can hide visible fields by dragging and dropping them onto the Customization Form, and return hidden fields to the pivot report when drop 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.

Expanded Excel 2007 Style

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

Similar 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. When end users move fields to the Hidden Fields section, the field's visibility is changed, but the field's area remains unchanged.

A list below displays additional capabilities provided by the Excel-style Customization Form:

  • Drag field's header between the Customization Form's area boxes to move the field to a specific area.
  • 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 using the filter buttons.

    Use the PivotGridOptionsCustomization.AllowSortInCustomizationForm and PivotGridOptionsCustomization.AllowFilterInCustomizationForm properties to specify whether or not end users are allowed to perform sorting and filtering in the Customization Form.

You can display hidden fields in a list or hierarchical structure. To learn more, see the User Folders topic.

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

Use the PivotGridOptionsCustomization.CustomizationFormAllowedLayouts property to list all the allowed layouts and prevent end users from selecting particular layouts.

To specify a preferred layout in code, use the PivotGridOptionsCustomization.CustomizationFormLayout property.

If a layout is not specified as allowed, it is hidden from the Customization Form Layout menu, and assigning it to the CustomizationFormLayout property has no effect.

Expanded See Also

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