MFC 中正確啟用/禁用選單項：ON_UPDATE_COMMAND_UI 詳解

問題背景

許多開發者嘗試用 CMenu::EnableMenuItem 動態啟用/禁用主選單項，卻發現無效。原因在於 MFC 採用完全不同的機制：命令 UI 更新（ON_UPDATE_COMMAND_UI）。

兩種 UI 更新策略

1. 神經質型：狀態改變時立即遍歷所有 UI 元素調用 Enable/Disable。維護成本極高，易遺漏。
2. 放鬆型（MFC 採用）：不維護 UI 狀態，僅在顯示前（使用者點開選單）按需更新。資料與介面解耦，單一職責。

MFC 運作流程

1. 使用者點擊選單，Windows 發送 WM_INITMENUPOPUP。
2. MFC 建立暫時 CCmdUI 物件，對每個選單項初始化並分派。
3. 透過訊息映射 ON_UPDATE_COMMAND_UI(ID_FOO, OnUpdateFoo) 調用處理函數。
4. 處理函數中根據程式狀態呼叫 pCmdUI->Enable(條件)。

範例代碼

void CMainFrame::OnUpdateFoo(CCmdUI* pCmdUI)
{
    // 假設文檔提供 GetReadOnly() 狀態
    pCmdUI->Enable(!m_pDocument->GetReadOnly());
}

// 複雜條件亦可
pCmdUI->Enable(m_bFoo && (GetStatusX() || GetStatusY()));

關鍵優勢

• 修改狀態的函數可能有 20 個，但更新 UI 的入口只有一個。
• CCmdUI::Enable 為虛函數，對選單項最終映射為 ::EnableMenuItem；同樣機制支援工具列按鈕、狀態列、組合框等。
• 若無對應 ON_UPDATE_COMMAND_UI，MFC 預設規則：有 ON_COMMAND 處理器則啟用，否則禁用。可設 m_bAutoMenuEnable = FALSE 強制全啟用。

適用範圍

處理函數可置於 CMainFrame、CView、CDocument、CWinApp 或任何 CCmdTarget 衍生類，命令透過 OnCmdMsg 路由。

結論

切勿在 MFC 中直接呼叫 EnableMenuItem，請改用 ON_UPDATE_COMMAND_UI 處理器，實現集中、可維護的 UI 狀態管理。