Log In
[Expand]General Information
[Collapse]WinForms Controls
 [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
  [Collapse]Pivot Grid
   [Expand]Getting Started
   [Expand]Binding to Data
   [Expand]Data Shaping
   [Expand]Data Analysis
     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]Design-time Features
   [Expand]UI Elements
   [Expand]End-User Capabilities
   [Expand]Member Tables
  [Expand]Tree List
  [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]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]Report Server
[Expand]eXpressApp Framework
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Customization Form Overview

The Customization Form feature provides capabilities for adding and removing fields from a Pivot Grid Control at runtime using drag-and-drop.

Dragging a field by its header and dropping it within a Customization Form's client area hides the field from the PivotGridControl. This field reappears when its header is dragged from the Customization Form to the Pivot Grid Control's client area. It is also possible to add fields to specific areas without using drag-and-drop. To do this, select the desired field header within the Customization Form, select the area in which the field should be placed and then click the Add To button.

The Customization Form can be invoked using one of the following methods:

Expanded Customization Form Settings

Fields can be dragged to the Customization Form if the Pivot Grid Control's PivotGridFieldOptions.AllowDrag property is set to true. To prevent individual fields from being moved, set their PivotGridFieldOptions.AllowDrag property to false. If the field's PivotGridFieldOptions.ShowInCustomizationForm property is set to false, its header cannot be displayed in the Customization Form. In this case, the only way to show the field within the Pivot Grid Control again is to change its PivotGridFieldBase.Visible property.

The PivotGridControl.ShowingCustomizationForm event is raised before the Customization Form is displayed. It allows you to customize the form, change its parent control (for instance, you can locate the Customization Form nearby the Pivot Grid Control instead of displaying it in a separate window), or replace it with a custom form.

To set the form's location and size, the PivotGridControl.CustomizationFormBounds property can be used.

The Customization Form can be closed by end-users, or it can be hidden programmatically, using the PivotGridControl.DestroyCustomization method. In both cases, the Customization Form is destroyed. If you need to perform any actions before the Customization Form is destroyed or simply respond to it being closed, handle the PivotGridControl.HideCustomizationForm event.

Expanded Advanced Capabilities

To learn about advanced Customization Form capabilities, see the following topics.

Expanded See Also

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