DashboardLayoutItem Class

Represents a layout item that displays a dashboard item.

Namespace: DevExpress.DashboardCommon

Assembly: DevExpress.Dashboard.v18.2.Core.dll

Declaration

C#

public class DashboardLayoutItem :
    DashboardLayoutNode

VB.NET

Public Class DashboardLayoutItem
    Inherits DashboardLayoutNode

Related API Members

The following members return DashboardLayoutItem objects:

• DashboardLayoutGroup.FindRecursive(DashboardItem)

Remarks

To display a dashboard item within a layout item, pass the DashboardItem descendant to the DashboardLayoutItem constructor.

The DashboardLayoutNode.Weight property allows you to specify the relative size of the created layout item.

Example

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:

• Three DashboardLayoutItem objects are created to display the existing dashboard items. The weight parameter specifies the layout item’s relative size.
• A new DashboardLayoutGroup is created to display two dashboard items. The Orientation parameter specifies how layout items are placed within the group.
• A root layout group is created. This group contains the previously created group and another layout item.
• The root layout group is assigned to the LayoutRoot property.

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.

Note

The complete sample project How to modify dashboard layout in code is available in the DevExpress Examples repository.

Form1.cs

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;
        }
    }
}

Form1.vb

Imports Microsoft.VisualBasic
Imports System
Imports DevExpress.XtraEditors
Imports DevExpress.DashboardCommon

Namespace Dashboard_LayoutCustomization
    Partial Public Class Form1
        Inherits XtraForm
        Public Sub New()
            InitializeComponent()
            dashboardViewer1.LoadDashboard("..\..\Data\Dashboard.xml")
        End Sub

        Private Sub btnUpdateLayout_Click(ByVal sender As Object, ByVal e As EventArgs) _
                Handles btnUpdateLayout.Click
            Dim dashboard As New Dashboard()
            dashboard.LoadFromXml("..\..\Data\Dashboard.xml")
            Dim grid As DashboardItem = CType(dashboard.Items(0), GridDashboardItem)
            Dim chart As DashboardItem = CType(dashboard.Items(1), ChartDashboardItem)
            Dim range As DashboardItem = CType(dashboard.Items(2), RangeFilterDashboardItem)

            ' Creates layout items used to display dashboard items.
            Dim gridItem As New DashboardLayoutItem(grid, 35)
            Dim chartItem As New DashboardLayoutItem(chart, 65)
            Dim rangeItem As New DashboardLayoutItem(range, 20)

            ' Creates a layout group that contains two layout items.
            Dim group1 As 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. 
            Dim rootGroup As New DashboardLayoutGroup(DashboardLayoutGroupOrientation.Vertical, _
                                                    1, group1, rangeItem)

            ' Specifies the root dashboard layout group.
            dashboard.LayoutRoot = rootGroup

            dashboardViewer1.Dashboard = dashboard
        End Sub
    End Class
End Namespace

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the DashboardLayoutItem class.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

VB.NET

wpf-dashboard-olap-data-provider/VB/WpfDashboard_OlapDataProvider/MainWindow.xaml.vb#L74

dBoard.Items.AddRange(cardItem, chartItem)
Dim cardLayoutItem As DashboardLayoutItem = New DashboardLayoutItem(cardItem)
Dim chartLayoutItem As DashboardLayoutItem = New DashboardLayoutItem(chartItem)

Inheritance

Object

DashboardLayoutNode

DashboardLayoutItem