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
  [Collapse]Data Grid
   [Expand]Getting Started
   [Expand]Binding to Data
   [Collapse]Grid View
    [Collapse]Columns and Card Fields
     [Collapse]Customization Form
       Customization Form Overview
       Implement Customization Form Functionality
       Customization Form Functionality for Banded Views
      Tutorial: Column Resizing
      Tutorial: Best Fit Option
      Tutorial: Auto Width Mode
      Tutorial: Fixed Columns
      Tutorial: Column Reordering
      Tutorial: Column Visibility
      Tutorial: Column Chooser API
      Column and Card Field Overview
      Data Cells
      Column Width Options - Auto-Width, Best Fit and Auto-Fill Column
      Column Visibility
      Creating Columns and Binding Them to Data Fields
      Fixed Columns
    [Expand]Rows and Cards
    [Expand]Row, Column and Cell Access API
    [Expand]Split Presentation
    [Expand]Cell Merging
    [Expand]Row Preview Sections
   [Expand]View Technology
   [Expand]Data Editing
   [Expand]Filtering and Locating Rows
   [Expand]Focus and Selection Handling
   [Expand]Processing Rows
   [Expand]Formatting Cell Values
   [Expand]Master-Detail Relationships
   [Expand]Asynchronous Image Load
   [Expand]Export and Printing
   [Expand]Appearance and Conditional Formatting
   [Expand]Batch Modifications
   [Expand]Hit Information
   [Expand]Popup Menus
   [Expand]Saving and Restoring Layouts
   [Expand]Visual Elements
   [Expand]Design-Time Features
   [Expand]End-User Capabilities
    Included Components
  [Expand]Vertical Grid
  [Expand]Pivot Grid
  [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]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Report Server
[Expand]eXpressApp Framework
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Customization Form Overview

Expanded Customization Form Overview

The Customization Form provides access to hidden columns and bands (in banded Views).

To hide a specific column/band, an end-user can do one of the following.

After columns/bands have been hidden, they can be restored by opening the Customization Form and dragging them from the Customization Form onto the Column Header Panel.

The Customization Form can be opened by:

Expanded Customization Form Settings

The Customization Form can be treated as an instance of the System.Windows.Forms.Form class. The GridView.CustomizationForm property provides access to the Customization Form. This allows you to customize the form as needed (change caption, size, etc.). The following code changes the Text, Opacity and FormBorderStyle properties.

To set the form's location and size, use the GridView.CustomizationFormBounds property.

By setting the GridOptionsCustomization.CustomizationFormSearchBoxVisible property (accessible through the GridView.OptionsCustomization property) to true, you can display the search box in the Customization Form. This search box allows an end-user to input a criterion and filter the list of available columns according to the specified criterion. See the figure below.


The Customization Form is recreated each time it is displayed. To customize the form each time it is displayed, handle the GridView.ShowCustomizationForm event.

The customization box can be closed by the end-user or it can be hidden programmatically by the GridView.DestroyCustomization method. In both cases, the Customization Form is destroyed. If you need to perform actions before the Customization Form is destroyed or simply respond to closing it, handle the GridView.HideCustomizationForm event. If the customization box is invoked again by the end-user or by the GridView.CustomizationForm method, the form will be recreated with the default settings.

Please refer to the Implement Customization Form Functionality topic for more information.

Expanded Banded Views Functionality

When using a Customization Form within the BandedGridView or AdvBandedGridView Views, it is also possible to drag bands to the customization box. You can drag the whole band to the customization box or change its GridBand.VisibleIndex property. Moving the band to the Customization Form affects the visibility of all columns and bands within the band. Customization options specifying band and column behavior within the Banded Grid Views can be accessed using the BandedGridView.OptionsCustomization property.

Expanded See Also

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