BaseView.DetailHeight Property

Gets or sets the height of a View when it serves as a detail View.

Namespace: DevExpress.XtraGrid.Views.Base

Assembly: DevExpress.XtraGrid.v18.2.dll

Declaration

C#

[DefaultValue(350)]
[XtraSerializableProperty]
[DXCategory("Appearance")]
public virtual int DetailHeight { get; set; }

VB.NET

<DefaultValue(350)>
<XtraSerializableProperty>
<DXCategory("Appearance")>
Public Overridable Property DetailHeight As Integer

Property Value

Type	Default	Description
Int32	350	An integer value specifying the View height in pixels.

Remarks

The DetailHeight property of pattern Views specifies the height its clones will have when expanding corresponding master rows. When changing the DetailHeight property of a clone view, this clone’s height is changed.

The following applies to Layout Views (LayoutView objects), when they are displayed as details.

A detail auto-height mode is enabled by default for detail Layout Views. In this mode, the value specified by the DetailHeight property is interpreted as the maximum detail height. The detail area’s height is shrunk to vertically fit displayed cards (you can specify the card layout and the number of card rows via the LayoutViewOptionsView.ViewMode and LayoutViewOptionsMultiRecordMode.MaxCardRows options).

The detail auto height feature is not in effect if card stretching is enabled via the StretchCardToViewHeight property (see LayoutViewOptionsSingleRecordMode.StretchCardToViewHeight and LayoutViewOptionsMultiRecordMode.StretchCardToViewHeight). In this instance, a detail’s height is specified by the DetailHeight property.

If you need a detail height to be fixed and equal to a specific value, disable the auto height feature via the LayoutView.DetailAutoHeight property and specify the required height via the DetailHeight property.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the DetailHeight 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-allow-a-user-to-edit-the-big-memoedit-cell-in-the-xtragrid-e895/CS/GridView_CalcRowHeight/Form1.cs#L20

InitializeComponent();
gridView1.DetailHeight = int.MaxValue;
InitData();

how-to-use-the-layoutview-cardview-as-a-master-view-in-master-detail-mode-e2428/CS/WindowsApplication3/MasterDetailHelper.cs#L136

ColumnViewInfo viewInfo = DetailView.GetViewInfo() as ColumnViewInfo;
Rectangle rect = new Rectangle(0, 0, view.GridControl.ClientSize.Width, DetailView.DetailHeight);
rect.Height = viewInfo.CalcRealViewHeight(rect, true) + 5;

VB.NET

how-to-allow-a-user-to-edit-the-big-memoedit-cell-in-the-xtragrid-e895/VB/GridView_CalcRowHeight/Form1.vb#L19

InitializeComponent()
gridView1.DetailHeight = Integer.MaxValue
InitData()

how-to-use-the-layoutview-cardview-as-a-master-view-in-master-detail-mode-e2428/VB/WindowsApplication3/MasterDetailHelper.vb#L147

Dim viewInfo As ColumnViewInfo = TryCast(DetailView.GetViewInfo(), ColumnViewInfo)
Dim rect As New Rectangle(0, 0, view.GridControl.ClientSize.Width, DetailView.DetailHeight)
rect.Height = viewInfo.CalcRealViewHeight(rect, True) + 5