GridView.CustomizationForm Property
Provides access to the Customization Form.
Namespace: DevExpress.XtraGrid.Views.Grid
Assembly: DevExpress.XtraGrid.v23.2.dll
NuGet Packages: DevExpress.Win.Grid, DevExpress.Win.Navigation
Declaration
Property Value
| Type | Description |
|---|---|
| DevExpress.XtraGrid.Views.Grid.Customization.CustomizationForm | A Form descendant representing the Customization Form. null (Nothing in Visual Basic) if the Customization Form is hidden. |
Remarks
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.
Note
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.
- GridControl.MainView - returns the top most View in a grid;
- GridControl.FocusedView - returns the focused View;
- GridControl.DefaultView - returns the currently maximized View;
- the sender parameter of View specific events;
- GridView.GetDetailView - returns a detail clone View for a specific master row.