DashboardToolbarMenuItem.ImageOptions Property

Provides access to properties that allow you to set up raster and vector images for the menu item.

Namespace: DevExpress.DashboardWin

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

Declaration

C#

public ImageOptions ImageOptions { get; }

VB.NET

Public ReadOnly Property ImageOptions As ImageOptions

Property Value

Type	Description
DevExpress.Utils.ImageOptions	A DevExpress.Utils.ImageOptions object that stores image-related settings.

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.