MFC 菜單編程完整指南：資源設計、命令映射、UI 更新機制、動態文本/勾選/啟用狀態控制實戰

編輯：關於C語言

菜單是 Windows 應用核心交互介面。MFC 提供資源編輯器設計、命令消息映射、ON_UPDATE_COMMAND_UI 動態狀態更新機制，支持運行時修改菜單文本、勾選狀態、啟用/禁用。本文系統講解菜單資源設計、雙重映射機制、CCmdUI 控制接口、完整實戰代碼模板。

一、菜單資源設計

資源編輯器中創建菜單資源 (IDR_MAINFRAME 或自定義 ID)
菜單項屬性設置關鍵字段：
- ID：命令標識 (如 ID_FILE_NEW)
- Caption：顯示文本 (含 & 設置加速鍵，如 &File)
- Prompt：狀態欄/工具提示文本，格式 「狀態欄說明\n工具欄提示」

Prompt 文本示例

ID_FILE_NEW: "創建新文檔\n新建"
ID_EDIT_COPY: "複製選中內容到剪貼板\n複製"
ID_VIEW_TOOLBAR: "顯示/隱藏工具欄\n工具欄"

二、雙重消息映射機制

在視圖類 (或文檔/框架/應用類) 中映射：

映射宏	觸發時機	處理函數原型	核心作用
`ON_COMMAND(id, func)`	用戶選中菜單項	`afx_msg void func()`	執行具體業務邏輯
`ON_UPDATE_COMMAND_UI(id, func)`	菜單即將顯示 (彈出前)	`afx_msg void func(CCmdUI* pCmdUI)`	動態設置啟用/勾選/文本

關鍵點

同一 ID 可同時映射兩個宏，分離「執行」與「狀態」邏輯
ON_UPDATE_COMMAND_UI 在菜單彈出時高頻調用，邏輯必須輕量
菜單項無 ON_COMMAND 映射時自動禁用

三、 CCmdUI 控制接口詳解

class CCmdUI {
public:
    void Enable(BOOL bOn);           // 啟用/禁用 (灰顯)
    void SetCheck(int nCheck);       // 勾選狀態: 0=無, 1=勾選, 2=單選點
    void SetText(LPCTSTR lpszText);  // 動態修改顯示文本
    void SetRadio(BOOL bOn);         // 設置單選狀態 (同 SetCheck)
    // 內部狀態
    BOOL m_bEnableChanged;
    BOOL m_bCheckChanged;
};

四、完整實戰代碼模板

場景

菜單「視圖 → 顯示網格」: 勾選切換，文本動態變化
菜單「編輯 → 複製」: 根據是否有選中內容啟用/禁用

頭文件聲明

class CMyView : public CView {
    // ...
    afx_msg void OnViewGrid();
    afx_msg void OnUpdateViewGrid(CCmdUI* pCmdUI);
    afx_msg void OnEditCopy();
    afx_msg void OnUpdateEditCopy(CCmdUI* pCmdUI);
    
    BOOL m_bShowGrid; // 狀態變量
    // ...
};

消息映射

BEGIN_MESSAGE_MAP(CMyView, CView)
    ON_COMMAND(ID_VIEW_GRID, OnViewGrid)
    ON_UPDATE_COMMAND_UI(ID_VIEW_GRID, OnUpdateViewGrid)
    ON_COMMAND(ID_EDIT_COPY, OnEditCopy)
    ON_UPDATE_COMMAND_UI(ID_EDIT_COPY, OnUpdateEditCopy)
END_MESSAGE_MAP()

實現代碼

// 執行命令：切換網格顯示
void CMyView::OnViewGrid() {
    m_bShowGrid = !m_bShowGrid; // 邏輯非
    Invalidate(); // 觸發重繪
    TRACE(_T("網格顯示: %s\n"), m_bShowGrid ? _T("開") : _T("關"));
}

// UI 更新：動態勾選 + 文本
void CMyView::OnUpdateViewGrid(CCmdUI* pCmdUI) {
    pCmdUI->SetCheck(m_bShowGrid ? 1 : 0); // 勾選狀態
    pCmdUI->SetText(m_bShowGrid ? _T("隱藏網格") : _T("顯示網格")); // 動態文本
    // 無需 Enable，默認啟用
}

// 執行命令：複製
void CMyView::OnEditCopy() {
    CopySelectionToClipboard();
}

// UI 更新：根據選中狀態啟用/禁用
void CMyView::OnUpdateEditCopy(CCmdUI* pCmdUI) {
    BOOL bHasSelection = HasValidSelection();
    pCmdUI->Enable(bHasSelection); // 核心：啟用/禁用
    // 可選：動態文本提示
    // pCmdUI->SetText(bHasSelection ? _T("複製") : _T("複製 (無選中)"));
}

五、進階技巧

1. 子菜單動態填充 (如最近文件列表)

void CMyApp::OnUpdateRecentFiles(CCmdUI* pCmdUI) {
    CMenu* pMenu = pCmdUI->m_pMenu; // 獲取菜單指針
    if (!pMenu) return;
    
    // 1. 刪除舊項 (保留分隔符前的固定項)
    int count = pMenu->GetMenuItemCount();
    for (int i = count - 1; i >= 0; --i) {
        UINT id = pMenu->GetMenuItemID(i);
        if (id >= ID_FILE_MRU_FILE1 && id <= ID_FILE_MRU_FILE16) {
            pMenu->DeleteMenu(i, MF_BYPOSITION);
        }
    }
    
    // 2. 添加最新文件列表
    for (int i = 0; i < m_recentFiles.GetSize(); ++i) {
        CString item;
        item.Format(_T("&%d %s"), i+1, m_recentFiles[i]);
        pMenu->InsertMenu(ID_FILE_MRU_FILE1 + i, MF_BYPOSITION | MF_STRING, 
                          ID_FILE_MRU_FILE1 + i, item);
    }
    
    pCmdUI->Enable(m_recentFiles.GetSize() > 0);
}

2. 右鍵上下文菜單

void CMyView::OnRButtonUp(UINT nFlags, CPoint point) {
    ClientToScreen(&point);
    CMenu menu;
    menu.LoadMenu(IDR_CONTEXT_MENU);
    CMenu* pPopup = menu.GetSubMenu(0);
    if (pPopup) {
        pPopup->TrackPopupMenu(TPM_LEFTALIGN | TPM_RIGHTBUTTON, 
                               point.x, point.y, this);
    }
}

3. 動態修改菜單項 (運行時增刪)

void CMyView::AddPluginMenuItems() {
    CMenu* pMenu = GetMenu()->GetSubMenu(2); // "工具" 菜單
    for (auto& plugin : m_plugins) {
        pMenu->AppendMenu(MF_STRING, plugin.cmdId, plugin.name);
        // 需在框架/視圖中 ON_COMMAND(plugin.cmdId, OnPluginCmd)
    }
}