GridOptionsDetail.AutoZoomDetail Property

Gets or sets whether detail views are automatically maximized to occupy the entire grid control area when their corresponding master rows are expanded.

Namespace : DevExpress.XtraGrid.Views.Grid

Assembly : DevExpress.XtraGrid.v25.2.dll

NuGet Packages : DevExpress.Win.Grid, DevExpress.Win.Navigation

csharp

[DefaultValue(false)]
[XtraSerializableProperty]
public virtual bool AutoZoomDetail { get; set; }

<DefaultValue(False)>
<XtraSerializableProperty>
Public Overridable Property AutoZoomDetail As Boolean

Property Value

Type	Default	Description
Boolean	false

true to automatically zoom into a detail view when its master row is expanded; otherwise, false.

Property Paths

You can access this nested property as listed below:

Object Type	Path to AutoZoomDetail
GridView

.OptionsDetail .AutoZoomDetail

Remarks

When the AutoZoomDetail property is enabled, expanding a master row automatically maximizes its detail view (zooms in).

Call the following methods to manually change the zoom state:

ZoomView() — zooms into the active detail view.
NormalView() — restores the grid to its normal layout (zooms out).

Use the GridControl.DefaultView property to obtain the currently maximized detail view. The grid raises the DefaultViewChanged event when a user zooms in or out of a detail view.

csharp

// Zoom out of the currently maximized detail view.
gridControl.DefaultView.NormalView();

See the following help topic for more information: Master-Detail Relationships — Zoom Detail Views.

Note

The AutoZoomDetail option’s functionality depends on GridOptionsDetail.AllowZoomDetail and GridOptionsDetail.EnableMasterViewMode options.