DashboardToolbarMenuItem Class

Drop-down menu element, contained in the dashboard title or dashboard item caption.

Namespace: DevExpress.DashboardWin

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

Declaration

C#

public class DashboardToolbarMenuItem :
    IDashboardToolbarItem

VB.NET

Public Class DashboardToolbarMenuItem
    Implements IDashboardToolbarItem

Remarks

Elements of this type are drop-down menu command buttons located in the dashboard title or dashboard item caption. They are contained in the DashboardToolbarItem.MenuItems collection of a command button. Command buttons are contained in the e.Items collection accessible in the following event handlers:

Component	Event
DashboardViewer	CustomizeDashboardTitle, CustomizeDashboardItemCaption
DashboardDesigner	CustomizeDashboardTitle, CustomizeDashboardItemCaption

Example

To add a drop-down menu item to the command button in the DashboardViewer’s dashboard title, handle the CustomizeDashboardTitle event, create a new .DashboardToolbarMenuItem instance, specify its characteristics and add it to the DashboardToolbarItem.MenuItems collection:

C#

using DevExpress.DashboardWin;
// ...
dashboardViewer.CustomizeDashboardTitle += DashboardViewer_CustomizeDashboardTitle;
// ...
private void DashboardViewer_CustomizeDashboardTitle(object sender, CustomizeDashboardTitleEventArgs e)
{
    DashboardViewer viewer = (DashboardViewer)sender;

    // Add drop-down menu to show/hide dashboard item captions.
    DashboardToolbarItem toolbarItemRoot = new DashboardToolbarItem();
    toolbarItemRoot.Caption = "Show Dashboard Item Captions";
    toolbarItemRoot.SvgImage = svgImageCollection1["title"];
    foreach (var item in viewer.Dashboard.Items)
    {
        DashboardToolbarMenuItem menuItem = new DashboardToolbarMenuItem(item.ShowCaption, item.Name,
            new Action<DashboardToolbarItemClickEventArgs>((args) =>
            {
                item.ShowCaption = !item.ShowCaption;
            }));
        menuItem.ImageOptions.SvgImage = svgImageCollection1["title"];
        toolbarItemRoot.MenuItems.Add(menuItem);
    }
    e.Items.Insert(0, toolbarItemRoot);
}

VB.NET

Imports DevExpress.DashboardWin
' ...
AddHandler dashboardViewer.CustomizeDashboardTitle, AddressOf DashboardViewer_CustomizeDashboardTitle
' ...
Private Sub DashboardViewer_CustomizeDashboardTitle(ByVal sender As Object, ByVal e As CustomizeDashboardTitleEventArgs)
    Dim viewer As DashboardViewer = DirectCast(sender, DashboardViewer)

    ' Add drop-down menu to show/hide dashboard item captions.
    Dim toolbarItemRoot As New DashboardToolbarItem()
    toolbarItemRoot.Caption = "Show Dashboard Item Captions"
    toolbarItemRoot.SvgImage = svgImageCollection1("title")
    For Each item In viewer.Dashboard.Items
        Dim menuItem As DashboardToolbarMenuItem = New DashboardToolbarMenuItem(item.ShowCaption, item.Name, New Action(Of DashboardToolbarItemClickEventArgs)(Sub(args)
            item.ShowCaption = Not item.ShowCaption
        End Sub))
        menuItem.ImageOptions.SvgImage = svgImageCollection1("title")
        toolbarItemRoot.MenuItems.Add(menuItem)
    Next item
    e.Items.Insert(0, toolbarItemRoot)

End Sub

Note

The complete sample project WinForms Dashboard - How to customize the dashboard title and dashboard item captions is available in the DevExpress Examples repository.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the DashboardToolbarMenuItem 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.

C#

winforms-dashboard-how-to-customize-the-dashboard-title-and-dashboard-item-captions-t630210/CS/CustomizeDashboardItemCaptionExample/ViewerForm1.cs#L52

foreach (var item in viewer.Dashboard.Items) {
    DashboardToolbarMenuItem menuItem = new DashboardToolbarMenuItem(item.ShowCaption, item.Name,
        new Action<DashboardToolbarItemClickEventArgs>((args) => {

VB.NET

winforms-dashboard-how-to-customize-the-dashboard-title-and-dashboard-item-captions-t630210/VB/CustomizeDashboardItemCaptionExample/ViewerForm1.vb#L55

For Each item In viewer.Dashboard.Items
    Dim menuItem As DashboardToolbarMenuItem = New DashboardToolbarMenuItem(item.ShowCaption, item.Name, New Action(Of DashboardToolbarItemClickEventArgs)(Sub(args)
        item.ShowCaption = Not item.ShowCaption

Implements

IDashboardToolbarItem

Inheritance

Object

DashboardToolbarMenuItem