Log In
[Expand]General Information
[Collapse]WinForms Controls
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Collapse]Data Grid
   [Expand]Getting Started
   [Expand]Binding to Data
   [Expand]Grid View
   [Expand]View Technology
   [Expand]Data Editing
   [Expand]Filtering and Locating Rows
   [Expand]Focus and Selection Handling
   [Expand]Processing Rows
   [Expand]Formatting Cell Values
   [Collapse]Master-Detail Relationships
     Master-Detail Overview
    [Expand]Binding to Data Specifics
    [Collapse]View Specifics
      Detail Pattern and Clone Views
      Specify Views to Represent Detail Data
      Master and Detail View Vertical Scrolling (Embedded Detail Mode)
      Detail View Size
      Synchronizing Detail Views
      Zooming Views
      Using Detail ToolTips
      Using Detail Tabs
    [Expand]Row Specifics
   [Expand]Asynchronous Image Load
   [Expand]Export and Printing
   [Expand]Appearance and Conditional Formatting
   [Expand]Batch Modifications
   [Expand]Hit Information
   [Expand]Popup Menus
   [Expand]Saving and Restoring Layouts
   [Expand]Visual Elements
   [Expand]Design-Time Features
   [Expand]End-User Capabilities
    Included Components
  [Expand]Vertical Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Report Server
[Expand]eXpressApp Framework
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Zooming Views

Expanded Zooming

Detail Views can be maximized to fit an entire grid control's area. This can be useful if you only wish to display particular detail data within a grid while hiding master View and other details. The end-user can maximize a detail View by clicking the Zoom Button:

After the View is maximized, the Zoom Button displays 'x' and you can use it to restore the original layout.

Starting from version 3.xx, CardViews support zooming.

Expanded Maximizing Views

To maximize a particular detail via code, call its BaseView.ZoomView method. The BaseView.NormalView method restores the original layout.

The following example shows how to maximize the first detail View for the focused master row and then restore the layout.

The GridControl.DefaultView property provides access to the currently maximized View. If no detail View is currently maximized, GridControl.DefaultView matches the GridControl.MainView property value.

To respond to View zooming (changing the GridControl.DefaultView property value), handle the GridControl.DefaultViewChanged event.

The following code shows how to zoom details when specific key combinations are pressed. To process shortcuts, we handle the GridControl.ProcessGridKey event. When the CTRL+RIGHT ARROW key combination is pressed, the focused View is maximized. Pressing the CTRL+LEFT ARROW keys restores a View's layout.

Expanded Zooming Settings

To disable maximizing details, you can set the GridOptionsDetail.AllowZoomDetail property of a master View to false. In this case, Zoom buttons are not displayed and you cannot maximize details via code.

If the GridOptionsDetail.AutoZoomDetail property is set to true, details are automatically maximized when expanding master rows. Note that this functionality is only available if GridOptionsDetail.AllowZoomDetail is true. After the detail is maximized, an end-user can restore the layout by clicking the 'X' zoom button. To restore the layout via code, call the BaseView.NormalView method.

If the master-detail mode is disabled by setting the GridOptionsDetail.EnableMasterViewMode property to false, details cannot be maximized either.

Expanded See Also

How would you rate this topic?​​​​​​​