GridView.CustomizationForm Property

Provides access to the Customization Form.

Namespace: DevExpress.XtraGrid.Views.Grid

Assembly: DevExpress.XtraGrid.v21.2.dll


public CustomizationForm CustomizationForm { get; }

Property Value

Type Description

A Form descendant representing the Customization Form. null (Nothing in Visual Basic) if the Customization Form is hidden.


Use the CustomizationForm property to access the Customization Form. The property’s return value is a Form descendant, thus you can customize the Customization Form as any windows form. Note that if you need to modify the form’s settings permanently, the GridView.ShowCustomizationForm event should be handled. This is because the Customization Form is recreated each time it is displayed. So, all changes are lost between hiding the form and showing it again. For instance, you need to handle the event to assign a context menu to the form.

You can also access the Customization Form’s settings directly. This can be used, for instance, to change the form’s position, etc.

Note: the CustomizationForm class representing the Customization Form provides the View property, so you can access the Customization Form’s owning View.

See Columns to learn more.


Detail pattern Views do not contain data and they are never displayed within XtraGrid. So, the CustomizationForm member must not be invoked for these Views. The CustomizationForm member can only be used with real Views that are displayed within the Grid Control. The real Views with which an end-user interacts at runtime can be accessed using the following methods.

See Also