Customization Form

  • 2 minutes to read

The Customization Form allows users to customize the layout of columns (and bands in Banded Grid Views). To invoke this form, select the Column Chooser (or the Column/Band Chooser) command from the column header context menu.

A Grid View supports two Customization Form types - default and advanced. Use the view.OptionsCustomization.UseAdvancedCustomizationForm option to switch to the advanced Customization Form.

Default Customization Form

Grid Views Banded Grid Views
VisualElems_GridView_CustomizationForm0 VisualElems_GridView_CustomizationForm
  • The form displays the headers of hidden columns and bands.
  • Users can show and hide columns/bands using drag-and-drop operations between the View and the Customization Form.
  • An optional search box allows users to locate columns/bands by their captions.

Display the Form

The GridView.ShowCustomization method.

The GridView.ShowCustomizationForm event.

Access the Form

GridView.CustomizationForm

Form Location and Bounds

GridView.CustomizationFormBounds

Form Sticking

GridOptionsCustomization.CustomizationFormSnapMode

Hide Columns in the Customization Form

OptionsColumn.ShowInCustomizationForm

Search Box

GridOptionsCustomization.CustomizationFormSearchBoxVisible

Filter Search Results

GridView.CustomizationFormSearch

Advanced Customization Form

Grid Views Banded Grid Views
  • The form displays the headers of visible and hidden columns and bands.
  • Users can show and hide columns/bands using drag-and-drop operations between the View and the Customization Form.
  • Column/band headers display check boxes that toggle column/band visibility.
  • A search box allows users to locate columns/bands by their captions.
  • The Sort button enables users to sort column/band headers.

Display the Form

The GridView.ShowCustomization method.

The GridView.ShowCustomizationForm event.

Access the Form

GridView.CustomizationForm

Form Location and Bounds

GridView.CustomizationFormBounds

Form Sticking

GridOptionsCustomization.CustomizationFormSnapMode

Hide Columns in the Customization Form

OptionsColumn.ShowInCustomizationForm

Filter Search Results

GridView.CustomizationFormSearch

Sort Column/Band Headers

GridOptionsCustomization.AdvancedCustomizationFormSortMode