GridControl.ViewRegistered Event

Fires when a new detail clone is created.

Namespace: DevExpress.XtraGrid

Assembly: DevExpress.XtraGrid.v19.1.dll

Declaration

C#

[DXCategory("Grid")]
public event ViewOperationEventHandler ViewRegistered

VB.NET

<DXCategory("Grid")>
Public Event ViewRegistered As ViewOperationEventHandler

Event Data

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

Property	Description
View	Gets the currently processed View.

Remarks

Detail clones are not stored in memory permanently. They are created and destroyed dynamically. When expanding a master row, a detail clone is created automatically to represent the detail data that becomes visible. If a master row has several details, other detail clones are created only when switching to them (making them visible). When collapsing a master row, all associated details are automatically destroyed.

When a detail clone is created, the grid control adds it to the GridControl.Views collection and raises the ViewRegistered event. The new detail View can be accessed via the event’s ViewOperationEventArgs.View parameter.

C#

using DevExpress.XtraGrid.Columns;
using DevExpress.XtraGrid.Views.Grid;

private void gridControl1_ViewRegistered(object sender, DevExpress.XtraGrid.ViewOperationEventArgs e) {
    GridView view = (GridView)e.View;
    foreach (GridColumn col in view.Columns) {
        if (col.FieldName == "Discount")
            col.Caption = "Percent";
    }
}

VB.NET

Imports DevExpress.XtraGrid.Columns
Imports DevExpress.XtraGrid.Views.Grid

Private Sub gridControl1_ViewRegistered(ByVal sender As Object, ByVal e As DevExpress.XtraGrid.ViewOperationEventArgs) _
    Handles gridControl1.ViewRegistered
    Dim view As GridView = CType(e.View, GridView)
    For Each col As GridColumn In view.Columns
        If col.FieldName = "Discount" Then
            col.Caption = "Percent"
        End If
    Next col
End Sub

Please refer to the Master-Detail Relationships topic for details.

The ViewRegistered event may also fire for the Main View (GridControl.MainView). This is the case if you subscribe to the event before the Main View has been set.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ViewRegistered 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#

how-to-expand-empty-master-rows-e3136/CS/Form1.cs#L20

gridControl1.DataSource = DataGenerator.GetData();
gridControl1.ViewRegistered += gridControl1_ViewRegistered;
gridView1.MasterRowEmpty += gridView1_MasterRowEmpty;

XPO_how-to-show-changed-object-properties-in-a-master-detail-grid-eg-winforms-xtragrid-e20030/CS/WindowsFormsApplication25/Form1.cs#L23

    gridView1.RowStyle += new DevExpress.XtraGrid.Views.Grid.RowStyleEventHandler(gridView1_RowStyle);
    gridControl1.ViewRegistered += new DevExpress.XtraGrid.ViewOperationEventHandler(gridControl1_ViewRegistered);
}

VB.NET

how-to-expand-empty-master-rows-e3136/VB/VB/Form1.vb#L19

gridControl1.DataSource = DataGenerator.GetData()
AddHandler gridControl1.ViewRegistered, AddressOf gridControl1_ViewRegistered
AddHandler gridView1.MasterRowEmpty, AddressOf gridView1_MasterRowEmpty

XPO_how-to-show-changed-object-properties-in-a-master-detail-grid-eg-winforms-xtragrid-e20030/VB/WindowsFormsApplication25/Form1.vb#L20

    AddHandler gridView1.RowStyle, New RowStyleEventHandler(AddressOf gridView1_RowStyle)
    AddHandler gridControl1.ViewRegistered, New DevExpress.XtraGrid.ViewOperationEventHandler(AddressOf gridControl1_ViewRegistered)
End Sub