GridOptionsDetail.SmartDetailExpandButtonMode Property

Gets or sets a value which specifies the manner in which master-detail expand buttons are painted.

Namespace: DevExpress.XtraGrid.Views.Grid

Assembly: DevExpress.XtraGrid.v18.2.dll

Declaration

C#

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

VB.NET

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

Property Value

Type	Default	Description
DetailExpandButtonMode	**Default**	A DetailExpandButtonMode enumeration value which specifies whether master-detail expand buttons are displayed grayed out when their associated details don’t contain any data.

Available values:

Name	Description
Default	The same as the DetailExpandButtonMode.CheckDefaultDetail option.
AlwaysEnabled	Master-detail expand buttons are always displayed in black.
CheckDefaultDetail	Display master-detail expand buttons as grayed out if the default detail is empty. The default detail is identified by the GridView.DefaultRelationIndex property
CheckAllDetails	Display master-detail expand buttons as grayed out if all details in the data source corresponding to a master row are empty. All details in the data source are checked, not only the details displayed by the Grid Control (see GridControl.ShowOnlyPredefinedDetails).

Property Paths

You can access this nested property as listed below:

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

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the SmartDetailExpandButtonMode 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-display-only-rows-with-non-empty-details-e465/CS/WindowsApplication28/Form1.cs#L26

listDataSource.Add(new Record(4, "Michael", 42, listDataSource, null));
gridView1.OptionsDetail.SmartDetailExpandButtonMode = DevExpress.XtraGrid.Views.Grid.DetailExpandButtonMode.CheckAllDetails;
gridControl1.DataSource = listDataSource;

VB.NET

how-to-display-only-rows-with-non-empty-details-e465/VB/WindowsApplication28/Form1.vb#L24

listDataSource.Add(New Record(4, "Michael", 42, listDataSource, Nothing))
gridView1.OptionsDetail.SmartDetailExpandButtonMode = DevExpress.XtraGrid.Views.Grid.DetailExpandButtonMode.CheckAllDetails
gridControl1.DataSource = listDataSource