GridView.IsMasterRowEmpty(Int32) Method

Indicates whether a particular master row’s default detail View is empty.

Namespace: DevExpress.XtraGrid.Views.Grid

Assembly: DevExpress.XtraGrid.v18.2.dll

Declaration

C#

public bool IsMasterRowEmpty(
    int rowHandle
)

VB.NET

Public Function IsMasterRowEmpty(
    rowHandle As Integer
) As Boolean

Parameters

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

Returns

Type	Description
Boolean	true if the master row’s default detail View is empty; otherwise, false.

Remarks

This method determines whether the detail clone identified by the GridView.DefaultRelationIndex property value has data. It uses the GridView.IsMasterRowEmptyEx method internally. Please refer to the latter method’s description for details.

Note

Detail pattern Views do not contain data and they are never displayed within XtraGrid. So, the IsMasterRowEmpty member must not be invoked for these Views. The IsMasterRowEmpty 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 IsMasterRowEmpty(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-expand-collapse-buttons-for-master-rows-without-detail-records-e3114/CS/A899Example/Form1.cs#L49

GridView view = sender as GridView;
if(e.Column.VisibleIndex == 0 && view.IsMasterRowEmpty(e.RowHandle))
    (e.Cell as GridCellInfo).CellButtonRect = Rectangle.Empty;

how-to-specify-visibility-of-rows-in-gridview-during-printing-export-e3174/CS/ExportToXlsx/ExportHelper.cs#L147

GridView view = sender as GridView;
if (view.IsMasterRowEmpty(e.ListSourceRow))
    e.Visible = false;

VB.NET

how-to-hide-expand-collapse-buttons-for-master-rows-without-detail-records-e3114/VB/A899Example/Form1.vb#L46

Dim view As GridView = TryCast(sender, GridView)
If e.Column.VisibleIndex = 0 AndAlso view.IsMasterRowEmpty(e.RowHandle) Then
    TryCast(e.Cell, GridCellInfo).CellButtonRect = Rectangle.Empty

how-to-specify-visibility-of-rows-in-gridview-during-printing-export-e3174/VB/ExportToXlsx/ExportHelper.vb#L143

Dim view As GridView = TryCast(sender, GridView)
If view.IsMasterRowEmpty(e.ListSourceRow) Then
    e.Visible = False