GridView.ExpandGroupRow(Int32) Method

Expands the specified group row.

Namespace: DevExpress.XtraGrid.Views.Grid

Assembly: DevExpress.XtraGrid.v21.1.dll

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

Declaration

C#

public void ExpandGroupRow(
    int rowHandle
)

VB.NET

Public Sub ExpandGroupRow(
    rowHandle As Integer
)

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.

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.

To expand group rows recursively use one of the other overloads of this method.

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 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.

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)

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ExpandGroupRow(Int32) method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-expand-visible-group-rows-when-the-user-searches-using-the-find-panel-e3903/CS/FindPanelExample/MainForm.cs#L40

        if (GridView.IsGroupRow(rowHandle))
            GridView.ExpandGroupRow(rowHandle);
}

VB.NET

how-to-expand-visible-group-rows-when-the-user-searches-using-the-find-panel-e3903/VB/FindPanelExample/MainForm.vb#L49

If GridView.IsGroupRow(rowHandle) Then
    GridView.ExpandGroupRow(rowHandle)
End If