[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
 [Expand]Getting Started
 [Expand]Basic Concepts and Terminology
 [Expand]Main Features
 [Collapse]Building the Designer and Viewer Applications
  [Expand]WinForms Designer
  [Collapse]WinForms Viewer
    Touch Support
    Adding the DashboardViewer Control
    Loading a Dashboard
    Providing Data
    Manage Printing and Exporting Capabilities
    Manage Interactivity Capabilities
    Manage Dashboard Parameters
    Customize Dashboard Colors
    Manage Dashboard Layout
    Obtaining Underlying and Displayed Data
    Access to Underlying Controls
    Popup Menus
   [Expand]Dialogs and Wizards
  [Expand]Web Dashboard
  [Expand]WPF Viewer
  [Expand]Web Viewer
 [Expand]Creating Dashboards
 [Expand]Design-Time Features
  Video Tutorials
  End-User Documentation
 [Expand]Redistribution and Deployment
 [Expand]Member Tables
 [Expand]API Reference
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Manage Dashboard Layout

The Dashboard Viewer provides end-users with the capability to resize dashboard items. You can also maximize/restore dashboard items, load and save the layout using the Dashboard API.


Open the dashboard in Dashboard Designer to define the initial dashboard items layout before loading a dashboard into Dashboard Viewer.

Expanded Item Resizing

End-users can click and drag a separator line between items to resize them.

Expanded Maximize and Restore Item

End-users can expand any dashboard item into the entire dashboard size to examine data in greater detail.

  • To maximize a dashboard item, click the Maximize button in the Dashboard Item Caption.

  • To restore the item size, click the Restore button.

In code, call the following methods:


Expands the specified dashboard item to the entire dashboard size to examine data in greater detail.


Restores the item size if an item is expanded to the entire dashboard size (maximized).

Expanded Load and Save Layout

Use the following methods to save/load the dashboard layout to/from a stream or XML file.


Saves a dashboard layout to a stream.


Loads a dashboard layout from an XML file.

After the dashboard layout is changed, the DashboardViewer.LayoutChanged event occurs.

Is this topic helpful?​​​​​​​