Customization Window Overview

  • 2 minutes to read

By default, the Customization Window is disabled. To enable it, set the ASPxGridViewBehaviorSettings.EnableCustomizationWindow property to true.

Customization Window's Functionality

End-users can drag column headers and move them to the Customization Window. Placing the column's header into the Customization Window sets the column's WebColumnBase.Visible property to false. If the column's GridViewColumn.ShowInCustomizationForm option is enabled, its header is displayed within the Customization Window.

To access and customize the Customization Window's settings, use the ASPxGridViewPopupControlSettings.CustomizationWindow property. These settings allow you to specify the Customization Window's availability and position.

Showing and Hiding

To show the Customization Window, use the client ASPxClientGridView.ShowCustomizationWindow method.

To hide the window, call the ASPxClientGridView.HideCustomizationWindow method. End-users can hide the window by clicking its Close button.

After the Customization Window has been closed, the ASPxClientGridView.CustomizationWindowCloseUp event is raised.

Use the ASPxClientGridView.IsCustomizationWindowVisible method to identify whether or not the Customization Window is visible.

Style

ASPxGridView provides a set of style properties that allow you to customize the appearance of various elements displayed within the Customization Window. These properties are listed in the table below.

Property Description
PopupControlStyles.CloseButton (via ASPxGridView.StylesPopup.CustomizationWindow.CloseButton) Contains style settings used to paint the Customization Window's Close button.
PopupControlStyles.Content (via ASPxGridView.StylesPopup.CustomizationWindow.Content) Contains style settings used to paint the Customization Window's content.
PopupControlStyles.Header (via ASPxGridView.StylesPopup.CustomizationWindow.Header) Contains style settings used to paint the Customization Window's header.