CustomMasterRowEventArgs.RowHandle Property

Gets the handle of the currently processed master row in the current View.

Namespace: DevExpress.XtraGrid.Views.Grid

Assembly: DevExpress.XtraGrid.v19.2.dll

Declaration

C#

public int RowHandle { get; }

VB.NET

Public ReadOnly Property RowHandle As Integer

Property Value

Type	Description
Int32	An integer value representing a row handle.

Remarks

Use the RowHandle property to identify the row for which an event has been raised. Note that in some instances, identifying the master row is insufficient. If a master row has several details, you also need to identify which detail is currently processed. For this purpose, read the CustomMasterRowEventArgs.RelationIndex property value.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the RowHandle property.

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-manage-the-expanded-rows-collection-when-the-master-detail-functionality-is-used-t470064/CS/View/CategoryView.cs#L27

fluentAPI.WithEvent<CustomMasterRowEventArgs>(categoryGridView, "MasterRowExpanded").EventToCommand(x => x.Update(null), ea => { return expandedMasterRowsManager.GetCategoryID(ea.RowHandle); });
fluentAPI.WithEvent<CustomMasterRowEventArgs>(categoryGridView, "MasterRowCollapsed").EventToCommand(x => x.Update(null), ea => { return expandedMasterRowsManager.GetCategoryID(ea.RowHandle); });

a-master-detail-grid-with-entity-framework-objects-e417/CS/CS/Entities/Form1.cs#L26

GridView view = sender as GridView;
Customers c = (Customers)view.GetRow(e.RowHandle);
e.IsEmpty = c.Orders.Count == 0;

how-to-display-ef-objects-in-a-grid-within-master-detail-mode-when-entities-have-many-to-man-e2766/CS/Entities/Form1.cs#L18

private void OnMasterRowEmpty(object sender, DevExpress.XtraGrid.Views.Grid.MasterRowEmptyEventArgs e) {
    Product p = (Product)gridView1.GetRow(e.RowHandle);
    e.IsEmpty = p.Order_Details.Count == 0;

how-to-show-a-treelistat-the-grids-detail-level-e2064/CS/Form1.cs#L67

e.ChildList = fakeList;
Parent parent = (sender as GridView).GetRow(e.RowHandle) as Parent;
UpdateTreeListData(parent);

multiple-selection-using-checkbox-in-a-master-detail-grid-e3507/CS/E3507/CheckMarkSelection.cs#L265

void view_MasterRowExpanded(object sender, CustomMasterRowEventArgs e) {
    GridView detailView = View.GetDetailView(e.RowHandle, e.RelationIndex) as GridView;
    GridCheckMarksSelection detailHelper = GetDetailSelectionHelper(e.RowHandle, e.RelationIndex);

VB.NET

how-to-manage-the-expanded-rows-collection-when-the-master-detail-functionality-is-used-t470064/VB/View/CategoryView.vb#L22

fluentAPI.WithEvent(Of CustomMasterRowEventArgs)(categoryGridView, "MasterRowExpanded").EventToCommand(Sub(x) x.Update(Nothing), Function(ea) expandedMasterRowsManager.GetCategoryID(ea.RowHandle))
fluentAPI.WithEvent(Of CustomMasterRowEventArgs)(categoryGridView, "MasterRowCollapsed").EventToCommand(Sub(x) x.Update(Nothing), Function(ea) expandedMasterRowsManager.GetCategoryID(ea.RowHandle))

a-master-detail-grid-with-entity-framework-objects-e417/VB/CS/Entities/Form1.vb#L27

Private Sub gridView1_MasterRowEmpty(ByVal sender As Object, ByVal e As DevExpress.XtraGrid.Views.Grid.MasterRowEmptyEventArgs) Handles gridView1.MasterRowEmpty
    Dim c As Customers = CType(gridView1.GetRow(e.RowHandle), Customers)
    e.IsEmpty = c.Orders.Count = 0

how-to-display-ef-objects-in-a-grid-within-master-detail-mode-when-entities-have-many-to-man-e2766/VB/Entities/Form1.vb#L20

Private Sub OnMasterRowEmpty(ByVal sender As Object, ByVal e As DevExpress.XtraGrid.Views.Grid.MasterRowEmptyEventArgs) Handles gridView1.MasterRowEmpty
    Dim p As Product = CType(gridView1.GetRow(e.RowHandle), Product)
    e.IsEmpty = p.Order_Details.Count = 0

how-to-show-a-treelistat-the-grids-detail-level-e2064/VB/Form1.vb#L57

e.ChildList = fakeList
Dim parent As Parent = TryCast((TryCast(sender, GridView)).GetRow(e.RowHandle), Parent)
UpdateTreeListData(parent)

multiple-selection-using-checkbox-in-a-master-detail-grid-e3507/VB/E3507/CheckMarkSelection.vb#L310

Private Sub view_MasterRowExpanded(ByVal sender As Object, ByVal e As CustomMasterRowEventArgs)
    Dim detailView As GridView = TryCast(View.GetDetailView(e.RowHandle, e.RelationIndex), GridView)
    Dim detailHelper As GridCheckMarksSelection = GetDetailSelectionHelper(e.RowHandle, e.RelationIndex)