GridView.GetRowLevel(Int32) Method

Returns the row’s group level.

Namespace: DevExpress.XtraGrid.Views.Grid

Assembly: DevExpress.XtraGrid.v19.2.dll

Declaration

C#

public virtual int GetRowLevel(
    int rowHandle
)

VB.NET

Public Overridable Function GetRowLevel(
    rowHandle As Integer
) As Integer

Parameters

Name	Type	Description
rowHandle	Int32	An integer value the row by its handle.

Returns

Type	Description
Int32	A zero-based integer representing the row’s group level.

Remarks

When data grouping is applied, group and data rows form a hierarchy. Data rows reside at the bottom hierarchy level. Levels of group rows depend on the position of corresponding grouping columns within the ColumnView.GroupedColumns collection. Group rows displayed at the root level correspond to the first column within that collection.

You can also obtain the group level of a row specified by its visible index. Use the GridView.GetVisibleRowLevel method for this purpose. Please refer to the Rows topic for details on row handles and visible indexes.

The image below shows a Grid View with two grouping levels:

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 GetRowLevel member must not be invoked for these Views. The GetRowLevel 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 GetRowLevel(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#L54

int result = view.GetParentRowHandle(rowHandle);
while(view.GetRowLevel(result) != rowInfo.level)
    result = view.GetParentRowHandle(result);

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

int result = view.GetParentRowHandle(rowHandle);
while (view.GetRowLevel(result) != rowInfo.level)
    result = view.GetParentRowHandle(result);

autosize-functionality-implementation-for-gridview-group-rows-e4367/CS/CustomGridControl/Form1.cs#L62

// current group row width obtaining
int requredWidth = viewInfo.ViewRects.Rows.Width - viewInfo.Painter.ElementsPainter.RowPreview.GetPreviewIndent(viewInfo) * (viewInfo.View.GetRowLevel(e.RowHandle) + 2);

how-to-edit-values-within-a-group-via-an-editable-group-row-e3065/CS/EditableGroupRow/GroupRowEdit.cs#L88

View.BeginSort();
GridColumn grColumn = View.GroupedColumns[View.GetRowLevel(rowToChangeHandle)];
List<int> indexList = new List<int>();

how-to-show-tooltips-for-summaries-displayed-in-a-group-row-e3195/CS/GroupRowSummaryHelper.cs#L34

info = e.Info as GridGroupRowInfo;
int level = view.GetRowLevel(e.RowHandle);
int row = view.GetDataRowHandleByGroupRowHandle(e.RowHandle);

VB.NET

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

Dim result As Integer = view.GetParentRowHandle(rowHandle)
While view.GetRowLevel(result) <> rowInfo.level
    result = view.GetParentRowHandle(result)

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

Dim result As Integer = view.GetParentRowHandle(rowHandle)
Do While view.GetRowLevel(result) <> rowInfo.level
    result = view.GetParentRowHandle(result)

autosize-functionality-implementation-for-gridview-group-rows-e4367/VB/CustomGridControl/Form1.vb#L59

' current group row width obtaining
Dim requredWidth As Integer = viewInfo.ViewRects.Rows.Width - viewInfo.Painter.ElementsPainter.RowPreview.GetPreviewIndent(viewInfo) * (viewInfo.View.GetRowLevel(e.RowHandle) + 2)

how-to-edit-values-within-a-group-via-an-editable-group-row-e3065/VB/EditableGroupRow/GroupRowEdit.vb#L76

View.BeginSort()
Dim grColumn As GridColumn = View.GroupedColumns(View.GetRowLevel(rowToChangeHandle))
Dim indexList As New List(Of Integer)()

how-to-show-tooltips-for-summaries-displayed-in-a-group-row-e3195/VB/GroupRowSummaryHelper.vb#L32

info = TryCast(e.Info, GridGroupRowInfo)
Dim level As Integer = view.GetRowLevel(e.RowHandle)
Dim row As Integer = view.GetDataRowHandleByGroupRowHandle(e.RowHandle)