GridView.GetParentRowHandle(Int32) Method

Determines a particular row’s parent group row.

Namespace: DevExpress.XtraGrid.Views.Grid

Assembly: DevExpress.XtraGrid.v19.1.dll

Declaration

C#

public int GetParentRowHandle(
    int rowHandle
)

VB.NET

Public Function GetParentRowHandle(
    rowHandle As Integer
) As Integer

Parameters

Name	Type	Description
rowHandle	Int32	The handle of the row whose parent row’s handle is to be obtained.

Returns

Type	Description
Int32	The handle of the parent group row for the specified child row.

Remarks

When grouping is applied to a view, group and data rows form a hierarchy. Data rows are at the bottom hierarchy level. Using the GetParentRowHandle method for data rows will return handles of group rows corresponding to the last column within the ColumnView.GroupedColumns collection. The method can be used to go further to the top of the hierarchy. Using the GetParentRowHandle for root group rows returns the value of the GridControl.InvalidRowHandle property. Root group rows correspond to the first column within the ColumnView.GroupedColumns collection.

Note

In server mode, the GetParentRowHandle returns the GridControl.InvalidRowHandle value if data is grouped by two or more columns.

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

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the GetParentRowHandle(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-hide-footers-based-on-the-number-of-rows-e4278/CS/HideableGroupRowFooters/CustomGridControl/MyGridViewInfo.cs#L98

    footerRowHandle = View.GetParentRowHandle(footerRowHandle);
}

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

protected int FindParentRowHandle(RowInfo rowInfo, int rowHandle) {
    int result = view.GetParentRowHandle(rowHandle);
    while(view.GetRowLevel(result) != rowInfo.level)

custom-gridcontrol-how-to-hide-particular-grouprow-headers-footers-t264208/CS/CustomGridControl/MyGridViewInfo.cs#L82

for(int i = 0; i < initialVisibleFootersCount; i++) {
    var parentRowVal = View.GetGroupRowValue(View.GetParentRowHandle(footerRowHandle));

how-to-preserve-the-xtragrid-view-state-in-multi-level-master-detail-e1466/CS/RefreshHelperClass.cs#L108

protected int FindParentRowHandle(GridView view, RowInfo rowInfo, int rowHandle) {
    int result = view.GetParentRowHandle(rowHandle);
    while (view.GetRowLevel(result) != rowInfo.level)

how-to-apply-the-even-odd-row-appearance-feature-to-each-set-of-grouped-rows-separately-e1345/CS/S131432/Form1.cs#L40

if(!gView.IsValidRowHandle(e.RowHandle)) return;
int parent = gView.GetParentRowHandle(e.RowHandle);
if(gView.IsGroupRow(parent))

VB.NET

how-to-hide-footers-based-on-the-number-of-rows-e4278/VB/HideableGroupRowFooters/CustomGridControl/MyGridViewInfo.vb#L94

    footerRowHandle = View.GetParentRowHandle(footerRowHandle)
Next i

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

Protected Function FindParentRowHandle(ByVal rowInfo As RowInfo, ByVal rowHandle As Integer) As Integer
    Dim result As Integer = view.GetParentRowHandle(rowHandle)
    While view.GetRowLevel(result) <> rowInfo.level

custom-gridcontrol-how-to-hide-particular-grouprow-headers-footers-t264208/VB/CustomGridControl/MyGridViewInfo.vb#L90

For i As Integer = 0 To initialVisibleFootersCount - 1
    Dim parentRowVal = View.GetGroupRowValue(View.GetParentRowHandle(footerRowHandle))

how-to-preserve-the-xtragrid-view-state-in-multi-level-master-detail-e1466/VB/RefreshHelperClass.vb#L118

Protected Function FindParentRowHandle(ByVal view As GridView, ByVal rowInfo As RowInfo, ByVal rowHandle As Integer) As Integer
    Dim result As Integer = view.GetParentRowHandle(rowHandle)
    Do While view.GetRowLevel(result) <> rowInfo.level

how-to-apply-the-even-odd-row-appearance-feature-to-each-set-of-grouped-rows-separately-e1345/VB/S131432/Form1.vb#L37

If Not gView.IsValidRowHandle(e.RowHandle) Then Return
Dim parent As Integer = gView.GetParentRowHandle(e.RowHandle)
If gView.IsGroupRow(parent) Then