GridControl.DefaultView Property

Gets the currently maximized View.

Namespace: DevExpress.XtraGrid

Assembly: DevExpress.XtraGrid.v19.1.dll

Declaration

C#

[Browsable(false)]
public BaseView DefaultView { get; }

VB.NET

<Browsable(False)>
Public ReadOnly Property DefaultView As BaseView

Property Value

Type	Description
BaseView	A BaseView descendant representing the currently maximized detail clone.

Remarks

The grid control enables you to maximize detail clones so that they are displayed as the main View. In this case, you can determine the currently maximized clone by reading the DefaultView property value. When no detail clone is maximized, the DefaultView property value matches the GridControl.MainView property value.

Please refer to the Master-Detail Relationships topic for details on maximizing detail clones.

Note: when the DefaultView property value changes, the GridControl.DefaultViewChanged event is raised.

Example

The example below shows how to maximize a detail View.

If the detail View does not exist, we should create it by expanding a specific master row. In our case, we obtain and work with the detail corresponding to the first master row.

After the master row is expanded, the detail View is obtained via GridView.GetDetailView.

Then the detail is maximized using the BaseView.ZoomView method. After that, the detail object and the GridControl.DefaultView property refer to the same maximized detail.

We use GridControl.DefaultView to group detail data rows by the “FUNCTION” column.

C#

    int rowHandle = 0;
    //Create the first detail by expanding a master row
    GridView gView = gridControl1.MainView as GridView;
    gView.SetMasterRowExpanded(rowHandle, true);
    //Get the first detail
    BaseView detail = gView.GetDetailView(rowHandle);
    if (detail != null) {
        detail.ZoomView();
        //Access the detail via DefaultView
        //Group by the FUNCTION column
        (gridControl1.DefaultView as GridView).Columns["FUNCTION"].GroupIndex = 0;
    }

VB.NET

    Dim rowHandle As Integer = 0
    'Create the first detail by expanding a master row
    Dim gView As GridView = CType(GridControl1.MainView, GridView)
    gView.SetMasterRowExpanded(rowHandle, True)
    'Get the first detail
    Dim detail As BaseView = gView.GetDetailView(rowHandle)
    If Not detail Is Nothing Then
        detail.ZoomView()
        'Access the detail via DefaultView
        'Group by the FUNCTION column
        CType(GridControl1.DefaultView, GridView).Columns("FUNCTION").GroupIndex = 0
    End If

Related GitHub Examples

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

XAF_how-to-change-a-column-order-in-a-list-view-after-a-user-clears-grouping-e80005/CS/Solution1.Module/MyViewController.cs#L32

GridControl grid = (GridControl) _listView.Control;
view = (GridView) grid.DefaultView;
view.GridMenuItemClick += new GridMenuItemClickEventHandler( view_GridMenuItemClick );

how-to-restore-the-auto-filter-row-from-an-active-filter-after-restoring-the-layout-e1759/CS/WindowsApplication1/E1759.cs#L37

grid.ForceInitialize();
GridView gridView = (GridView)grid.DefaultView;
gridView.RestoreLayoutFromStream(typeof(E1759).Assembly.GetManifestResourceStream("WindowsApplication1.layout.xml"));

how-to-sort-columns-checked-filter-drop-down-list-e1714/CS/WindowsApplication1/E1714.cs#L40

ColumnView columnView = ((ColumnView)grid.DefaultView);
foreach (GridColumn column in columnView.Columns)

VB.NET

XAF_how-to-change-a-column-order-in-a-list-view-after-a-user-clears-grouping-e80005/VB/Solution1.Module/MyViewController.vb#L35

Dim grid As GridControl = CType(_listView.Control, GridControl)
_view = CType(grid.DefaultView, GridView)
AddHandler _view.GridMenuItemClick, AddressOf view_GridMenuItemClick

how-to-restore-the-auto-filter-row-from-an-active-filter-after-restoring-the-layout-e1759/VB/WindowsApplication1/E1759.vb#L37

grid.ForceInitialize()
Dim view As GridView = CType(grid.DefaultView, GridView)
view.RestoreLayoutFromStream(GetType(E1759).Assembly.GetManifestResourceStream("layout.xml"))

how-to-sort-columns-checked-filter-drop-down-list-e1714/VB/WindowsApplication1/E1714.vb#L36

Dim columnView As ColumnView = (CType(grid.DefaultView, ColumnView))
For Each column As GridColumn In columnView.Columns