Skip to main content
BuyLog In
Business Intelligence Dashboard
Search in…
Docs > Common Features > Dashboard Layout
A newer version of this page is available. .
All docs
V18.2
Dashboard
Getting Started
Basic Concepts and Terminology
Common Features
Supported Data Sources
Connecting to a Data Source
Data Preparation
Binding to Data
Data Shaping
Interactivity
Appearance Customization
Advanced Analytics
Dashboard Layout
Printing and Exporting
Creating the Designer and Viewer Applications
Creating Dashboards
Visual Studio Integration
End-User Documentation
Localization
Redistribution and Deployment
Video Tutorials
Examples
Member Tables
.NET Framework API Reference
.NET Core API Reference
JavaScript API Reference
Download CHM

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 container items using drag-and-drop operations. You can also arrange and resize dashboard items using an API provided by the Dashboard class.

Layout_ItemsLayoutMain

Layout Concepts

The dashboard arranges dashboard items using layout items and layout containers in a hierarchical structure that represents the dashboard layout.

  • A layout item contains and displays an individual dashboard item. A layout item is the DashboardLayoutItem class in Dashboard API.
  • A layout group is 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. A layout group is the DashboardLayoutGroup class in Dashboard API.
  • A layout tab page is a container for layout items and groups. It is the DashboardLayoutTabPage class in Dashboard API.
  • A layout tab container is a container for layout tab pages. It is the DashboardLayoutTabContainer Dashboard API.

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:

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