GridView.CustomizationForm Property
Provides access to the Customization Form.
Namespace: DevExpress.XtraGrid.Views.Grid
Assembly: DevExpress.XtraGrid.v19.2.dll
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 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.
- 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.