Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

GridView.GroupRowCollapsing Event

Occurs before group rows are collapsed.

Namespace: DevExpress.XtraGrid.Views.Grid

Assembly: DevExpress.XtraGrid.v24.2.dll

NuGet Packages: DevExpress.Win.Grid, DevExpress.Win.Navigation

#Declaration

[DXCategory("Behavior")]
public event RowAllowEventHandler GroupRowCollapsing

#Event Data

The GroupRowCollapsing 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 GroupRowCollapsing event is raised when an attempt to collapse a group row is made. Note that it doesn’t matter whether this is done by end-users or via code. The row is identified by the RowEventArgs.RowHandle parameter. To prevent the row from being collapsed set the RowAllowEventArgs.Allow parameter to false.

Group rows can be collapsed recursively via the GridView.SetRowExpanded method overload with the recursive parameter set to true. In this case, the GroupRowCollapsing event is raised only once (for the row which is passed as this method’s parameter). For nesting rows, this event is not raised.

This event is also called when all group rows are collapsed at the same time (via a group panel context menu or GridView.CollapseAllGroups 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.

See Also