GridControl.MainView Property

Gets or sets the View that displays data at the top hierarchy level.

Namespace: DevExpress.XtraGrid

Assembly: DevExpress.XtraGrid.v18.2.dll

Declaration

C#

[Browsable(false)]
[DefaultValue(null)]
public BaseView MainView { get; set; }

VB.NET

<Browsable(False)>
<DefaultValue(Nothing)>
Public Property MainView As BaseView

Property Value

Type	Default	Description
BaseView	*null*	A BaseView descendant representing the View that displays data at the top hierarchy level.

Remarks

When the grid control doesn’t display master-detail data, the View specified by the MainView property is the only View that displays data. By default, when the grid control is created, it initializes the MainView property with a GridView object with default settings. Thus, if you need to display data using a Card View, create a new CardView object and assign it to the MainView property.

When using the grid control to display master-detail relationships, the MainView property specifies the View that will represent the top level data. This is the data specified by the grid control’s GridControl.DataSource and GridControl.DataMember properties. Detail data is represented by Views stored within the GridControl.LevelTree tree or supplied by the master View’s GridView.MasterRowGetLevelDefaultView event handler.

All Views currently displayed are stored within the GridControl.Views collection. The first element in the collection is the MainView property value. Other elements are added or removed dynamically when detail clones are expanded and collapsed respectively.

Note

Do not set the MainView property while wrapping the setter with the GridControl.BeginUpdate and GridControl.EndUpdate method pair. Instead, set the MainView property outside the BeginUpdate/EndUpdate block.

Related GitHub Examples

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

grid-views-and-grid-controls-view-repository-e3828/CS/DXWindowsApplication5/Form1.cs#L64

    BaseView selectedView = gridControl1.ViewCollection[comboBox.SelectedIndex - 1];
    gridControl1.MainView = selectedView;
}

how-to-provide-a-custom-datasource-for-the-print-preview-form-options-dialog-e3589/CS/CustomPrintPreviewTest/CustomGridViewPrintingTest.cs#L16

gc.ForceInitialize();
gc.MainView = new CustomGridView(gc);
GridColumn col = ((ColumnView)gc.MainView).Columns.AddField("Column");

mvvmexpenses-sample-application-t254492/CS/MVVMExpenses/Views/Account/AccountsEditFormView.cs#L31

((GridView)gridControl1.MainView).OptionsBehavior.Editable = false;
((GridView)gridControl1.MainView).Columns["Account"].Visible = false;

how-to-change-the-size-of-the-scroll-bar-buttons-in-the-gridview-e2105/CS/Q251885/MainForm.cs#L17

private void OnSwitchViewButtonClick(object sender, EventArgs e) {
    if (categoriesGrid.MainView == categoriesViewSimple)
        categoriesGrid.MainView = categoriesViewLayout;

how-to-provide-sorting-functionality-for-the-grid-that-allows-drag-and-drop-row-reordering-e3149/CS/E3149/Form1.cs#L352

GridControl grid = sender as GridControl;
GridView view = grid.MainView as GridView;
GridHitInfo hitInfo = view.CalcHitInfo(grid.PointToClient(new Point(e.X, e.Y)));

VB.NET

grid-views-and-grid-controls-view-repository-e3828/VB/DXWindowsApplication5/Form1.vb#L59

    Dim selectedView As BaseView = gridControl1.ViewCollection(comboBox.SelectedIndex - 1)
    gridControl1.MainView = selectedView
End If

how-to-provide-a-custom-datasource-for-the-print-preview-form-options-dialog-e3589/VB/CustomPrintPreviewTest/CustomGridViewPrintingTest.vb#L16

gc.ForceInitialize()
gc.MainView = New CustomGridView(gc)
Dim col As GridColumn = CType(gc.MainView, ColumnView).Columns.AddField("Column")

how-to-change-the-size-of-the-scroll-bar-buttons-in-the-gridview-e2105/VB/Q251885/MainForm.vb#L19

Private Sub OnSwitchViewButtonClick(ByVal sender As Object, ByVal e As EventArgs) Handles simpleButton1.Click
    If categoriesGrid.MainView Is categoriesViewSimple Then
        categoriesGrid.MainView = categoriesViewLayout

how-to-provide-sorting-functionality-for-the-grid-that-allows-drag-and-drop-row-reordering-e3149/VB/E3149/Form1.vb#L330

Dim grid As GridControl = TryCast(sender, GridControl)
Dim view As GridView = TryCast(grid.MainView, GridView)
Dim hitInfo As GridHitInfo = view.CalcHitInfo(grid.PointToClient(New Point(e.X, e.Y)))

office-insipred-application-rolodex-e20070/VB/Main.vb#L40

Case 0
    grid.MainView = view
Case 1