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

Implement Customization Form Functionality

Expanded Implement Customization Form Functionality

This topic describes the advanced features of the Customization Form within the GridView in detail. The Customization Form Overview document provides brief information about the Customization Form functionality and end-user capabilities. See the Customization Form Functionality for Banded Views topic to get more information about implementing a Customization Form within banded Views.

You can move the column into the Customization Form by using drag and drop. This feature is enabled if the GridView.CanDragColumn method returns true. You can disable a column's drag and drop feature by using its OptionsColumn.AllowMove and View's GridOptionsCustomization.AllowColumnMoving options.

Placing a column into a Customization Form sets a column's GridColumn.Visible property to false. To move a column from a View to the Customization Form programmatically, set the column's GridColumn.Visible property to false manually. Note, however, that even if the column cannot be dragged, you can move a column to the Customization Form using this property.

Note: if the column's OptionsColumn.ShowInCustomizationForm option is not set, the column header cannot be displayed in the Customization Form. In this case, the only way to show the column within a View again is to change the column's GridColumn.Visible property.

The GridView.CustomizationRowCount property specifies the number of rows within a customization box. It can vary from 3 to 30. If you set the property value to a value less than 3 or more than 30 it is automatically changed to 3 or 30 respectively. The image below contains examples of customization boxes where the GridView.CustomizationRowCount property is set to 3 and 5.

If the number of columns within a customization box exceeds the number of rows, then a vertical scrollbar is displayed.

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. To perform particular actions before the customization box is closed, handle the GridView.HideCustomizationForm event.

Expanded See Also

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