GridView.ExpandGroupRow(Int32, Boolean) Method

Expands the specified group row and optionally any child group rows at all nesting levels.

Namespace: DevExpress.XtraGrid.Views.Grid

Assembly: DevExpress.XtraGrid.v19.2.dll

Declaration

C#

public void ExpandGroupRow(
    int rowHandle,
    bool recursive
)

VB.NET

Public Sub ExpandGroupRow(
    rowHandle As Integer,
    recursive As Boolean
)

Parameters

Name	Type	Description
rowHandle	Int32	An integer value identifying the group row by its handle. If the specified handle points to a data row this method does nothing.
recursive	Boolean	true to expand any child group rows at all nesting levels; false to preserve the expanded state of any child group rows.

Remarks

The ExpandGroupRow method raises the GridView.GroupRowExpanding event. This event allows preventing the group row from being expanded. If a row has been expanded the GridView.GroupRowExpanded event is raised.

Please refer to the Working with Groups in Code topic for additional information.

Note

Detail pattern Views do not contain data and they are never displayed within XtraGrid. So, the ExpandGroupRow member must not be invoked for these Views. The ExpandGroupRow 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.

Example

The following example expands the focused group row.

C#

if (gridView1.IsGroupRow(gridView1.FocusedRowHandle))
    gridView1.ExpandGroupRow(gridView1.FocusedRowHandle);

VB.NET

If gridView1.IsGroupRow(gridView1.FocusedRowHandle) Then gridView1.ExpandGroupRow(gridView1.FocusedRowHandle)