Skip to main content

DashboardDesigner.UpdateDashboardItemCaption(String) Method

Fires the CustomizeDashboardItemCaption event for the specified dashboard item.

Namespace: DevExpress.DashboardWin

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


public void UpdateDashboardItemCaption(
    string dashboardItemName


Name Type Description
dashboardItemName String

A String that is the dashboard item name accessible using the ComponentName property.


This example demonstrates how to load data in the Dashboard designer on demand when all required filters are set. For this, the Show Data button is created in the DashboardDesigner.CustomizeDashboardTitle event handler.

View Example: WinForms Dashboard - How to delay data load until all filters are set

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

namespace CustomShowDataExample
    public partial class DesignerForm1 : DevExpress.XtraBars.Ribbon.RibbonForm
        public DesignerForm1()
            dashboardDesigner.CustomizeDashboardTitle += DashboardDesigner_CustomizeDashboardTitle;

        #region #CustomizeDashboardTitle
        private void DashboardDesigner_CustomizeDashboardTitle(object sender, 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
See Also