Skip to main content

GridView.CustomizationForm Property

Provides access to the Customization Form.

Namespace: DevExpress.XtraGrid.Views.Grid

Assembly: DevExpress.XtraGrid.v22.2.dll

NuGet Package: DevExpress.Win.Grid


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 Views that display real data within the Grid Control. Use the following methods to access these Views with which an end user interacts at runtime.

See Also