GridView.GetDataRowHandleByGroupRowHandle(Int32) Method

Returns the row handle of the first data row within a group.

Namespace: DevExpress.XtraGrid.Views.Grid

Assembly: DevExpress.XtraGrid.v23.2.dll

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

Declaration

C#

public int GetDataRowHandleByGroupRowHandle(
    int groupRowHandle
)

VB.NET

Public Function GetDataRowHandleByGroupRowHandle(
    groupRowHandle As Integer
) As Integer

Parameters

Name	Type	Description
groupRowHandle	Int32	Specifies the group row by its row handle.

Returns

Type	Description
Int32	The row handle of the first grid row owned by the target group.

Remarks

The GetDataRowHandleByGroupRowHandle method searches all nesting hierarchy levels. This means that the row obtained is not necessarily the group row’s immediate child. Note that if the groupRowHandle parameter refers to a data row, the function simply returns the parameter value.

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 GetDataRowHandleByGroupRowHandle member must not be invoked for these Views. The GetDataRowHandleByGroupRowHandle 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.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the GetDataRowHandleByGroupRowHandle(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#

winforms-preserve-grid-state-on-refresh/CS/RefreshHelperClass.cs#L92

if(dataRowHandle < 0) // group row
    dataRowHandle = view.GetDataRowHandleByGroupRowHandle(dataRowHandle);
rowInfo.Id = view.GetRowCellValue(dataRowHandle, column);

winforms-grid-display-custom-rows/CS/CustomRowInGrid/CustomRowInGrid/Form1.cs#L108

{
    int index = gridView1.GetDataRowHandleByGroupRowHandle(e.RowHandle);

VB.NET

winforms-preserve-grid-state-on-refresh/VB/RefreshHelperClass.vb#L99

rowInfo.level = view.GetRowLevel(dataRowHandle)
If dataRowHandle < 0 Then dataRowHandle = view.GetDataRowHandleByGroupRowHandle(dataRowHandle) ' group row
rowInfo.Id = view.GetRowCellValue(dataRowHandle, column)

winforms-grid-display-custom-rows/VB/CustomRowInGrid/Form1.vb#L111

Private Sub gridView1_CustomDrawGroupRow(ByVal sender As Object, ByVal e As DevExpress.XtraGrid.Views.Base.RowObjectCustomDrawEventArgs) Handles gridView1.CustomDrawGroupRow
    Dim index As Integer = gridView1.GetDataRowHandleByGroupRowHandle(e.RowHandle)