在CDialog/CDialogEx中使用CMFCToolBar菜单按钮时菜单项全禁用的问题

核心原因 #

CMFCToolBar的菜单按钮默认不会自动触发对话框的命令UI更新逻辑，且其菜单显示流程不会触发对话框的OnInitMenuPopup，导致菜单项无法被正确启用。

具体解决步骤 #

1. 确认命令更新处理程序正确注册 #

确保对话框类的消息映射中已添加对应菜单命令的更新处理：

BEGIN_MESSAGE_MAP(CYourDialog, CDialogEx)
    // ... 其他消息映射
    ON_UPDATE_COMMAND_UI(ID_MENU_ITEM_1, &CYourDialog::OnUpdateMenuItem1)
    ON_UPDATE_COMMAND_UI(ID_MENU_ITEM_2, &CYourDialog::OnUpdateMenuItem2)
END_MESSAGE_MAP()

实现更新处理函数，根据实际业务逻辑设置启用状态：

void CYourDialog::OnUpdateMenuItem1(CCmdUI* pCmdUI)
{
    // 示例：始终启用，可替换为业务判断逻辑
    pCmdUI->Enable(TRUE);
}

void CYourDialog::OnUpdateMenuItem2(CCmdUI* pCmdUI)
{
    pCmdUI->Enable(IsSomeConditionMet());
}

2. 让工具栏在空闲时触发UI更新 #

重载对话框的OnIdle函数，强制工具栏执行命令UI更新：
首先在对话框头文件中声明：

virtual BOOL OnIdle(LONG lCount);

然后实现：

BOOL CYourDialog::OnIdle(LONG lCount)
{
    CDialogEx::OnIdle(lCount);
    // 触发工具栏的命令UI更新，将对话框作为命令目标
    m_ToolBar.OnUpdateCmdUI(this, FALSE);
    return TRUE; // 返回TRUE表示继续处理空闲事件
}

3. 确保菜单句柄有效性 #

初始化菜单按钮时，注意Detach()的使用，避免原CMenu对象提前销毁导致菜单句柄失效：

CMenu menu;
if (menu.LoadMenu(IDR_MENU_TOOLBAR_REPORT_VIEWER))
{
    CMenu* pSubMenu = menu.GetSubMenu(0);
    if (pSubMenu)
    {
        CMFCToolBarMenuButton menuButton((UINT)-1, pSubMenu->Detach(), 2, L"", TRUE);
        m_ToolBar.ReplaceButton(ID_MANAGE_REPORT_VIEWER, menuButton);
        m_ToolBar.AdjustLayout();
        m_ToolBar.AdjustSizeImmediate();
    }
}

4. 强制命令路由指向对话框 #

如果以上步骤无效，可手动设置工具栏的命令目标为对话框：

m_ToolBar.SetOwner(this);
m_ToolBar.SetRouteCommandsViaFrame(false);

额外说明 #

• UpdateDialogControls仅处理对话框标准控件的状态，对CMFCToolBar的菜单按钮无效。
• 工具栏菜单显示时不会触发对话框的OnInitMenuPopup，无需依赖该函数做更新。

内容的提问来源于stack exchange，提问作者Andrew Truckle