如何通过ImageIndex为嵌套的ToolStripMenuItem编程添加菜单图标

问题原因 #

子菜单项所属的ToolStripDropDownMenu不会自动继承顶层MenuStrip的ImageList属性，所以即使设置了子项的ImageIndex，也找不到对应的图片资源加载，这就是子菜单图标不显示的核心原因。

解决方法 #

方案1：给子菜单的下拉容器设置ImageList（适合单层级子菜单） #

直接给controllerToolStripMenuItem的下拉容器绑定ImageList，它的所有子项就可以正常读取ImageList里的资源：

private void LoadSubMenuIcons()
{
    menuStrip1.ImageList = ImageList;
    controllerToolStripMenuItem.ImageIndex = 2;
    // 核心配置：给下拉容器绑定ImageList
    controllerToolStripMenuItem.DropDown.ImageList = ImageList;

    foreach (ToolStripItem subMenuItem in controllerToolStripMenuItem.DropDownItems)
    {
        if (subMenuItem is ToolStripMenuItem)
        {
            subMenuItem.ImageIndex = 2;
        }
    }
}

方案2：递归处理所有层级子菜单（适合多层嵌套子菜单） #

如果子菜单下还有多级嵌套菜单，可以用递归方法统一给所有层级的下拉容器绑定ImageList：

private void LoadSubMenuIcons()
{
    menuStrip1.ImageList = ImageList;
    controllerToolStripMenuItem.ImageIndex = 2;
    // 递归处理所有子菜单
    SetAllSubMenuImageList(controllerToolStripMenuItem, ImageList);
}

private void SetAllSubMenuImageList(ToolStripMenuItem parentMenu, ImageList imageList)
{
    // 给当前菜单的下拉容器绑定ImageList
    parentMenu.DropDown.ImageList = imageList;
    foreach (ToolStripItem item in parentMenu.DropDownItems)
    {
        if (item is ToolStripMenuItem subMenu)
        {
            subMenu.ImageIndex = 2;
            // 递归处理下一级子菜单
            SetAllSubMenuImageList(subMenu, imageList);
        }
    }
}

可选简化方案 #

如果不想处理容器的ImageList配置，也可以直接给子项赋值Image属性，无需依赖父容器的ImageList设置：

subMenuItem.Image = ImageList.Images[2];

内容的提问来源于stack exchange，提问作者Andy Rehn