General Information
.NET Subscription
Quality Assurance and Productivity
Desktop
Frameworks and Libraries
Web
Controls and Extensions
Maintenance Mode
Enterprise and Analytic Tools
End-User Documentation
Dashboard Layout
- 2 minutes to read
WinForms and Web Designers provide the capability to arrange and resize dashboard items on the dashboard surface and within the group or tab container items using drag-and-drop operations. You can also arrange and resize dashboard items using an API provided by the Dashboard class.
Layout Concepts
The dashboard uses layout items and layout containers to arrange dashboard items in a hierarchical structure. This structure is called a dashboard layout.
| Element | Description | API (Desktop / Web) |
|---|---|---|
| Layout item | Contains and displays an individual dashboard item. | DashboardLayoutItem DashboardLayoutItem |
| Layout group | A container that is used to arrange layout items (or other layout groups) either horizontally or vertically. At the same time, layout groups are containers that display dashboard item groups. | DashboardLayoutGroup DashboardLayoutGroup |
| Layout tab page | A container for layout items and groups. | DashboardLayoutTabPage DashboardLayoutTabPage |
| Layout tab container | A container for layout tab pages. | DashboardLayoutTabContainer DashboardLayoutTabContainer |
Thus, a dashboard layout is hierarchically arranged from the root layout group to bottommost layout items, which display individual dashboard items.
The dashboard in the picture below illustrates a tabbed layout containing items and groups.
Its layout hierarchy is shown in the following diagram:
The Dashboard class exposes the Dashboard.LayoutRoot property, which provides access to the root dashboard layout group.
Use the DashboardLayoutGroup.ChildNodes property to add child layout groups and items to the parent group (in particular, to the root group). The DashboardLayoutGroup.Orientation property allows you to specify whether the orientation of layout items/groups within the group is vertical or horizontal.
You can determine the immediate parent of the current layout item/group using the DashboardLayoutNode.Parent property. To determine the root (or topmost) group for a layout item/group, use the DashboardLayoutNode.Root property.
How to Change Layout
These topics describe how to specify a dashboard layout in the WinForms and Web Designers.