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, click Column Chooser (or Column/Band Chooser) in the column header context menu.

In addition to the default form, the control supports an advanced form. Use a grid view’s UseAdvancedCustomizationForm option to switch to the advanced form. The static UseAdvancedCustomizationForm property allows you to enable the advanced form for all views.

Default Customization Form

The default customization form supports the following features:

  • The form displays hidden column (and band) headers.
  • Users can drag columns (bands) between the view and form to show and hide them.
  • An optional search box allows users to locate columns (bands) by their captions.
Grid Views Banded Grid Views
VisualElems_GridView_CustomizationForm0 VisualElems_GridView_CustomizationForm

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

In addition to the default form features, the advanced form supports the following features:

  • Column (band) headers display check boxes that toggle column (band) visibility.
  • Users can sort column (band) headers.
Grid Views Banded Grid Views
image image

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