GridView.MasterRowExpanded Event

Fires immediately after a particular detail clone has become visible.

Namespace: DevExpress.XtraGrid.Views.Grid

Assembly: DevExpress.XtraGrid.v24.1.dll

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

Declaration

C#

[DXCategory("MasterDetail")]
public event CustomMasterRowEventHandler MasterRowExpanded

VB.NET

<DXCategory("MasterDetail")>
Public Event MasterRowExpanded As CustomMasterRowEventHandler

Event Data

The MasterRowExpanded event's data class is CustomMasterRowEventArgs. The following properties provide information specific to this event:

Property	Description
RelationIndex	Gets the relation index that identifies the affected detail.
RowHandle	Gets the handle of the currently processed master row in the current View.

Remarks

The MasterRowExpanded event fires when expanding a master row or when switching between details. The master row can be determined using the CustomMasterRowEventArgs.RowHandle parameter. The detail can be identified using the CustomMasterRowEventArgs.RelationIndex parameter.

The MasterRowExpanded event serves as a notification only and cannot cancel the action. To control whether details can shown, handle the GridView.MasterRowExpanding event instead.

If you need to handle detail clones creation, handle the grid control’s GridControl.ViewRegistered event.

Please refer to the Master-Detail Relationships topic for additional information.

Related GitHub Examples

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

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-grid-auto-expand-new-master-row/CS/Q205071/Form1.cs#L46

private void ExpandNewRow(GridView view) {
    view.MasterRowExpanded += new CustomMasterRowEventHandler(OnGridViewMasterRowExpanded);
    view.SetMasterRowExpanded(view.GetRowHandle(((IList)view.DataSource).Count - 1), true);

winforms-grid-select-detail-rows-when-selecting-master-row/CS/MasterDetailSelectionHelper.cs#L19

_GridView = gridView;
_GridView.MasterRowExpanded += _GridView_MasterRowExpanded;
_GridView.SelectionChanged += _GridView_SelectionChanged;

VB.NET

winforms-grid-auto-expand-new-master-row/VB/Q205071/Form1.vb#L48

Private Sub ExpandNewRow(ByVal view As GridView)
    AddHandler view.MasterRowExpanded, New CustomMasterRowEventHandler(AddressOf OnGridViewMasterRowExpanded)
    view.SetMasterRowExpanded(view.GetRowHandle(CType(view.DataSource, IList).Count - 1), True)

winforms-grid-select-detail-rows-when-selecting-master-row/VB/MasterDetailSelectionHelper.vb#L17

_GridView = gridView
AddHandler _GridView.MasterRowExpanded, AddressOf _GridView_MasterRowExpanded
AddHandler _GridView.SelectionChanged, AddressOf _GridView_SelectionChanged