A layout group used to arrange layout items or other groups within a dashboard.
Namespace: DevExpress.DashboardCommon
Assembly: DevExpress.Dashboard.v18.2.Core.dll
public class DashboardLayoutGroup :
DashboardLayoutNodePublic Class DashboardLayoutGroup
Inherits DashboardLayoutNode
ImplementsThe DashboardLayoutGroup class exposes the DashboardLayoutGroup.ChildNodes property that provides access to the collection of child layout groups and items that constitute the current layout group. Use the DashboardLayoutGroup.Orientation property to specify the orientation of layout items/groups within the group.
The DashboardLayoutGroup.Weight property allows specifying the relative size of the layout group.
The following example demonstrates how to modify dashboard layout in code.
In this example, the DashboardViewer loads a dashboard containing three dashboard items placed vertically, one above the other. The following steps are taken to create a new layout:
This example also demonstrates how to swap layout items using the MoveRight(DashboardLayoutNode) method, save and restore the layout using the SaveDashboardLayout(String) and LoadDashboardLayout(String) methods.
The complete sample project How to modify dashboard layout in code is available in the DevExpress Examples repository.
using System;
using DevExpress.XtraEditors;
using DevExpress.DashboardCommon;
namespace Dashboard_LayoutCustomization {
public partial class Form1 : XtraForm {
public Form1() {
InitializeComponent();
dashboardViewer1.LoadDashboard(@"..\..\Data\Dashboard.xml");
}
private void btnUpdateLayout_Click(object sender, EventArgs e) {
Dashboard dashboard = new Dashboard();
dashboard.LoadFromXml(@"..\..\Data\Dashboard.xml");
DashboardItem grid = (GridDashboardItem)dashboard.Items[0];
DashboardItem chart = (ChartDashboardItem)dashboard.Items[1];
DashboardItem range = (RangeFilterDashboardItem)dashboard.Items[2];
// Creates layout items used to display dashboard items.
DashboardLayoutItem gridItem = new DashboardLayoutItem(grid, 35);
DashboardLayoutItem chartItem = new DashboardLayoutItem(chart, 65);
DashboardLayoutItem rangeItem = new DashboardLayoutItem(range, 20);
// Creates a layout group that contains two layout items.
DashboardLayoutGroup group1 =
new DashboardLayoutGroup(DashboardLayoutGroupOrientation.Horizontal, 80,
gridItem, chartItem);
// Creates a root layout group that contains the previously created group and
// the layout item displaying the Range Filter dashboard item.
DashboardLayoutGroup rootGroup =
new DashboardLayoutGroup(DashboardLayoutGroupOrientation.Vertical, 1,
group1, rangeItem);
// Specifies the root dashboard layout group.
dashboard.LayoutRoot = rootGroup;
dashboardViewer1.Dashboard = dashboard;
}
}
}