GridView.GroupRowExpanding Event
Occurs when a group row is about to be expanded.
Namespace: DevExpress.XtraGrid.Views.Grid
Assembly: DevExpress.XtraGrid.v24.1.dll
NuGet Packages: DevExpress.Win.Grid, DevExpress.Win.Navigation
Declaration
Event Data
The GroupRowExpanding event's data class is RowAllowEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| Allow | Gets or sets a value specifying whether the current operation is allowed. |
| RowHandle | Gets the row’s handle (position). For the ColumnView.RowUpdated event, this property specifies the previous handle (position) of the currently processed row. NewItemRowHandle value when a new row is added. Inherited from RowEventArgs. |
Remarks
The GroupRowExpanding event is raised when an attempt to expand a group row is made. Note that it doesn’t matter whether this is done by end-users or via code. The row about to be expanded can be identified using the RowEventArgs.RowHandle parameter. To stop the row from being expanded, set the RowAllowEventArgs.Allow parameter to false.
Group rows can be expanded recursively via the GridView.SetRowExpanded method overload with the recursive parameter set to true. In this case, the GroupRowExpanding event is raised only once (for the row passed as this method’s parameter). For nesting rows, this event is not raised.
This event is also called when all group rows are expanded at the same time (via a group panel context menu or GridView.ExpandAllGroups method). In this case, the RowEventArgs.RowHandle parameter is set to GridControl.InvalidRowHandle.
Please refer to the Working with Groups in Code topic for additional information.