Skip to main content

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

Declaration

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

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.

// 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.

See Also