GridOptionsDetail.DetailMode Property

Gets or sets whether detail Views are painted in Classic mode (master and detail Views have their own vertical scrollbars) or Embedded mode (a single vertical scrollbar is used throughout the grid control).

Namespace: DevExpress.XtraGrid.Views.Grid

Assembly: DevExpress.XtraGrid.v19.2.dll

Declaration

C#

[DefaultValue(DetailMode.Default)]
[XtraSerializableProperty]
public virtual DetailMode DetailMode { get; set; }

VB.NET

<DefaultValue(DetailMode.Default)>
<XtraSerializableProperty>
Public Overridable Property DetailMode As DetailMode

Property Value

Type	Default	Description
DevExpress.XtraGrid.Views.Grid.DetailMode	**Default**	A value that specifies the current detail mode. The DetailMode.Default value is equivalent to Classic.

Property Paths

You can access this nested property as listed below:

Object Type	Path to DetailMode
AdvBandedGridView	.OptionsDetail.DetailMode
BandedGridView	.OptionsDetail.DetailMode
GridView	.OptionsDetail.DetailMode

Remarks

The animations below demonstrate the Classic and Embedded modes.

Classic

Embedded

The following features are not supported in Embedded detail mode.

• Horizontal scroll bars in detail Views.
• Pixel-based vertical scrolling (see GridOptionsBehavior.AllowPixelScrolling).

• The LayoutView, TileView and WinExplorerView cannot be used as detail Views.

  Only the following Views are supported as detail Views: GridView, BandedGridView, AdvBandedGridView and CardView.

• Setting a detail View’s height. The BaseView.DetailHeight property is ignored.
• The display of the New Item Row at the top in detail Views.
• The Auto Filter Row in detail Views.
• Navigating through records using the Embedded Data Navigator or ControlNavigator.
• “Fixed Groups” (see GridOptionsBehavior.AllowFixedGroups).
• Group summaries in the master View’s group footers.
• Zooming (maximizing) details (see GridOptionsDetail.AllowZoomDetail)

Related GitHub Examples

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

how-to-emulate-a-treelist-using-the-master-detail-gridview-e2290/CS/E2290/Form1.cs#L55

if(this.barCheckItem1.Checked) {
    this.myGridView2.OptionsDetail.DetailMode = DevExpress.XtraGrid.Views.Grid.DetailMode.Embedded;
    this.myGridView3.OptionsDetail.DetailMode = DevExpress.XtraGrid.Views.Grid.DetailMode.Embedded;

use-only-one-scroll-bar-for-a-grid-with-multiple-master-detail-levels-e4376/CS/Form1.cs#L17

    InitializeComponent();
    myGridView1.OptionsDetail.DetailMode = DevExpress.XtraGrid.Views.Grid.DetailMode.Embedded;
}

VB.NET

how-to-emulate-a-treelist-using-the-master-detail-gridview-e2290/VB/E2290/Form1.vb#L57

If Me.barCheckItem1.Checked Then
    Me.myGridView2.OptionsDetail.DetailMode = DevExpress.XtraGrid.Views.Grid.DetailMode.Embedded
    Me.myGridView3.OptionsDetail.DetailMode = DevExpress.XtraGrid.Views.Grid.DetailMode.Embedded

use-only-one-scroll-bar-for-a-grid-with-multiple-master-detail-levels-e4376/VB/Form1.vb#L17

    InitializeComponent()
    myGridView1.OptionsDetail.DetailMode = DevExpress.XtraGrid.Views.Grid.DetailMode.Embedded
End Sub