DashboardDesigner.CustomizeDashboardTitle Event

Allows you to customize the dashboard title at runtime.

Namespace: DevExpress.DashboardWin

Assembly: DevExpress.Dashboard.v19.1.Win.dll

Declaration

C#

public event CustomizeDashboardTitleEventHandler CustomizeDashboardTitle

VB.NET

Public Event CustomizeDashboardTitle As CustomizeDashboardTitleEventHandler

Event Data

The CustomizeDashboardTitle event's data class is CustomizeDashboardTitleEventArgs. The following properties provide information specific to this event:

Property	Description
FilterText	Gets or sets the text displayed in the dashboard title or in the dashboard item caption. The text identifies a single master filter value applied to the dashboard. Inherited from CustomizeDashboardCaptionBaseEventArgs.
Items	Provides access to command buttons located in the dashboard title or in the dashboard item’s caption. Inherited from CustomizeDashboardCaptionBaseEventArgs.
Text	Gets or sets the text displayed in the dashboard title or the dashboard item caption. Inherited from CustomizeDashboardCaptionBaseEventArgs.

Remarks

The DashboardDesigner.CustomizeDashboardTitle event is raised when the dashboard is loaded (the DashboardDesigner.Dashboard property is changed) or when end-user activities affect the dashboard title. Such activities include applying a master filter, performing drill-down or changing the parameter value.

You can change displayed text, remove existing buttons, add custom buttons or command bar items, including drop-down menus.

Example

Note

The complete sample project WinForms Dashboard - How to delay data load until all filters are set is available in the DevExpress Examples repository.

C#

using DevExpress.DashboardWin;
using System;
using System.Linq;

namespace CustomShowDataExample
{
    public partial class DesignerForm1 : DevExpress.XtraBars.Ribbon.RibbonForm
    {
        public DesignerForm1()
        {
            InitializeComponent();
            dashboardDesigner.CustomizeDashboardTitle += DashboardDesigner_CustomizeDashboardTitle;
            dashboardDesigner.LoadDashboard(@"..\..\Dashboards\dashboard1.xml");
        }

        #region #CustomizeDashboardTitle
        private void DashboardDesigner_CustomizeDashboardTitle(object sender, DevExpress.DashboardWin.CustomizeDashboardTitleEventArgs e)
        {
            DevExpress.Data.IParameter showDataParameter = dashboardDesigner.Parameters.FirstOrDefault(p => p.Name == "ShowData");
            if (showDataParameter != null)
            {
                bool showData = (bool)showDataParameter.Value;
                DashboardToolbarItem showDataItem = new DashboardToolbarItem(showData, "Select states in the State list box and click this button to display data",
                    new Action<DashboardToolbarItemClickEventArgs>((args) => {
                        showDataParameter.Value = !showData;
                    }));
                showDataItem.Caption = "Show Data";
                showDataItem.SvgImage = svgImageCollection1[0];
                e.Items.Insert(0, showDataItem);
            }
        }
        #endregion #CustomizeDashboardTitle
    }
}

VB.NET

Imports DevExpress.DashboardWin
Imports System
Imports System.Linq

Namespace CustomShowDataExample
    Partial Public Class DesignerForm1
        Inherits DevExpress.XtraBars.Ribbon.RibbonForm

        Public Sub New()
            InitializeComponent()
            AddHandler dashboardDesigner.CustomizeDashboardTitle, AddressOf DashboardDesigner_CustomizeDashboardTitle
            dashboardDesigner.LoadDashboard("..\..\Dashboards\dashboard1.xml")
        End Sub

        #Region "#CustomizeDashboardTitle"
        Private Sub DashboardDesigner_CustomizeDashboardTitle(ByVal sender As Object, ByVal e As DevExpress.DashboardWin.CustomizeDashboardTitleEventArgs)
            Dim showDataParameter As DevExpress.Data.IParameter = dashboardDesigner.Parameters.FirstOrDefault(Function(p) p.Name = "ShowData")
            If showDataParameter IsNot Nothing Then
                Dim showData As Boolean = CBool(showDataParameter.Value)
                Dim showDataItem As DashboardToolbarItem = New DashboardToolbarItem(showData, "Select states in the State list box and click this button to display data", New Action(Of DashboardToolbarItemClickEventArgs)(Sub(args)
                    showDataParameter.Value = Not showData
                End Sub))
                showDataItem.Caption = "Show Data"
                showDataItem.SvgImage = svgImageCollection1(0)
                e.Items.Insert(0, showDataItem)
            End If
        End Sub
        #End Region ' #CustomizeDashboardTitle
    End Class
End Namespace

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the CustomizeDashboardTitle event.

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.

C#

winforms-dashboard-how-to-delay-data-load-until-all-filters-are-set-t629796/CS/CustomShowDataExample/DesignerForm1.cs#L12

InitializeComponent();
dashboardDesigner.CustomizeDashboardTitle += DashboardDesigner_CustomizeDashboardTitle;
dashboardDesigner.LoadDashboard(@"..\..\Dashboards\dashboard1.xml");

winforms-dashboard-item-collection-changed-event/CS/Dashboard_ItemCollectionChanged_Example/Form1.cs#L19

dashboardDesigner1.DashboardLoaded += DashboardDesigner1_DashboardLoaded;
dashboardDesigner1.CustomizeDashboardTitle += DashboardDesigner1_CustomizeDashboardTitle;
dashboardDesigner1.Dashboard = new Dashboard();

winforms-dashboard-designer-merge-dashboards-to-tabs/CS/DesignerForm.cs#L17

dashboardDesigner.CreateRibbon();
dashboardDesigner.CustomizeDashboardTitle += DashboardDesignerCustomizeDashboardTitle;
dashboardDesigner.UpdateDashboardTitle();

winforms-dashboard-beforeexportdocument-event/CS/WinForms_Dashboard_BeforeExportEvent_Example/Form1.cs#L14

dashboardDesigner1.ConfigureDataConnection += DashboardDesigner1_ConfigureDataConnection;
dashboardDesigner1.CustomizeDashboardTitle += DashboardDesigner1_CustomizeDashboardTitle;
dashboardDesigner1.LoadDashboard(@"Data\Dashboard2Print.xml");

winforms-dashboard-designer-how-to-customize-a-data-store-schema-for-sql-data-sources-e5051/CS/Dashboard_CustomSchemaProvider/Form1.cs#L8

dashboardDesigner1.CreateRibbon();
dashboardDesigner1.CustomizeDashboardTitle += DashboardDesigner1_CustomizeDashboardTitle;

VB.NET

winforms-dashboard-how-to-delay-data-load-until-all-filters-are-set-t629796/VB/CustomShowDataExample/DesignerForm1.vb#L11

InitializeComponent()
AddHandler dashboardDesigner.CustomizeDashboardTitle, AddressOf DashboardDesigner_CustomizeDashboardTitle
dashboardDesigner.LoadDashboard("..\..\Dashboards\dashboard1.xml")

winforms-dashboard-item-collection-changed-event/VB/Dashboard_ItemCollectionChanged_Example/Form1.vb#L18

AddHandler dashboardDesigner1.DashboardLoaded, AddressOf DashboardDesigner1_DashboardLoaded
AddHandler dashboardDesigner1.CustomizeDashboardTitle, AddressOf DashboardDesigner1_CustomizeDashboardTitle
dashboardDesigner1.Dashboard = New Dashboard()

winforms-dashboard-designer-merge-dashboards-to-tabs/VB/DesignerForm.vb#L18

dashboardDesigner.CreateRibbon()
AddHandler dashboardDesigner.CustomizeDashboardTitle, AddressOf DashboardDesignerCustomizeDashboardTitle
dashboardDesigner.UpdateDashboardTitle()

winforms-dashboard-beforeexportdocument-event/VB/WinForms_Dashboard_BeforeExportEvent_Example/Form1.vb#L13

AddHandler dashboardDesigner1.ConfigureDataConnection, AddressOf DashboardDesigner1_ConfigureDataConnection
AddHandler dashboardDesigner1.CustomizeDashboardTitle, AddressOf DashboardDesigner1_CustomizeDashboardTitle
dashboardDesigner1.LoadDashboard("Data\Dashboard2Print.xml")

winforms-dashboard-designer-how-to-customize-a-data-store-schema-for-sql-data-sources-e5051/VB/Dashboard_CustomSchemaProvider/Form1.vb#L10

dashboardDesigner1.CreateRibbon()
AddHandler dashboardDesigner1.CustomizeDashboardTitle, AddressOf DashboardDesigner1_CustomizeDashboardTitle