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 ASPxClientGridView.ShowCustomizationWindow client 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. |