MFC 按鈕控件設置圖標的三種方法對比

需求場景

在 MFC 對話框/視圖中，為按鈕控件（CButton）設置圖標（Icon）是常見 UI 需求。本文對比三種獲取 HICON 句柄的方法，並給出完整設置流程。

核心步驟

1. 獲取按鈕控件指針：CButton* pBtn = (CButton*)GetDlgItem(IDC_MY_BUTTON);
2. 加載圖標資源獲取 HICON
3. 調用 pBtn->SetIcon(hIcon) 設置
4. 按鈕屬性設置：BS_ICON 風格、或 BS_BITMAP 配合 SetBitmap

三種加載圖標方法對比

方法一：AfxGetApp()->LoadIconW（推薦用於 MFC 應用程序資源）

// 資源 ID：IDI_MY_ICON（在 .rc 中定義）
HICON hIcon = AfxGetApp()->LoadIconW(IDI_MY_ICON);
// 或舊版：LoadIcon(IDI_MY_ICON) // 內部調用 AfxGetInstanceHandle()

• 優點：MFC 封裝，自動管理模塊句柄，支持共享 DLL 中的資源查找
• 適用：主應用程序模塊、擴展 DLL 中的圖標資源
• 注意：返回的 HICON 由系統管理，**不可調用 DestroyIcon**，卸載模塊時自動釋放

方法二：LoadIconW(AfxGetApp()->m_hInstance, MAKEINTRESOURCE(ID))

// 顯式指定實例句柄
HICON hIcon = LoadIconW(AfxGetApp()->m_hInstance, MAKEINTRESOURCE(IDI_MY_ICON));

• 優點：Win32 API 直接調用，語義明確，適用於非 MFC 代碼或需指定特定模塊句柄場景
• 缺點：需手動確保 m_hInstance 正確（常規 MFC App 通常無問題）
• 資源管理：同方法一，系統自動管理生命周期

方法三：LoadIconW(hInst, MAKEINTRESOURCE(ID)) —— 通用標準寫法

// 最標準的 Win32 寫法，MAKEINTRESOURCE 將整數 ID 轉為資源字符串指針
HICON hIcon = LoadIconW(AfxGetApp()->m_hInstance, MAKEINTRESOURCE(IDI_MY_ICON));

• 優點：跨語言/框架通用，明確展示資源加載機制（整數 ID → 字符串指針轉換）
• 關鍵點：MAKEINTRESOURCE 宏將 16 位整數 ID 轉換為 LPCWSTR 類型指針，高位為 0，系統識別為資源 ID 而非字符串指針

完整代碼示例

void CMyDialog::OnInitDialog()
{
    CDialogEx::OnInitDialog();

    // 1. 獲取按鈕控件指針
    CButton* pBtn = (CButton*)GetDlgItem(IDC_BUTTON_ICON);
    if (!pBtn) return;

    // 2. 設置按鈕風格為圖標模式（資源編輯器中勾選 "Icon" 屬性即可，代碼中可補充）
    pBtn->ModifyStyle(0, BS_ICON);

    // 3. 加載圖標（推薦方法一）
    HICON hIcon = AfxGetApp()->LoadIconW(IDI_ICON_MYAPP);
    if (hIcon)
    {
        // 4. 設置圖標
        pBtn->SetIcon(hIcon);
        
        // 可選：設置圖標大小（需按鈕足夠大，系統自動縮放）
        // pBtn->SetIcon(hIcon, BS_ICON); // 已在 ModifyStyle 設置
    }

    // 5. 若需文字+圖標組合，建議使用 CBitmapButton 或自繪按鈕
}

進階：圖標與文字組合顯示

標準 CButton 僅支持純圖標或純文本。實現「圖標+文字」兩種方案：

方案 A：使用 CBitmapButton（位圖按鈕）

• 準備四狀態位圖：正常、按下、聚焦、禁用
• 位圖上繪製圖標+文字組合
• CBitmapButton::AutoLoad 自動加載

方案 B：自繪按鈕（Owner Draw）

class CIconTextButton : public CButton
{
    DECLARE_DYNAMIC(CIconTextButton)
    HICON m_hIcon;
    CString m_strText;
    int m_nIconTextGap; // 圖標文字間距

public:
    void SetIconText(HICON hIcon, LPCTSTR lpszText, int nGap = 4)
    { m_hIcon = hIcon; m_strText = lpszText; m_nIconTextGap = nGap; Invalidate(); }

protected:
    virtual void DrawItem(LPDRAWITEMSTRUCT lpDIS)
    {
        CDC dc; dc.Attach(lpDIS->hDC);
        CRect rc = lpDIS->rcItem;
        UINT state = lpDIS->itemState;

        // 背景繪製
        dc.FillSolidRect(rc, GetSysColor(COLOR_BTNFACE));
        if (state & ODS_SELECTED) dc.DrawEdge(rc, EDGE_SUNKEN, BF_RECT);
        else dc.DrawEdge(rc, EDGE_RAISED, BF_RECT);

        // 計算圖標+文字總寬度居中
        CSize szIcon(16, 16); // 假設 16x16
        CSize szText = dc.GetTextExtent(m_strText);
        int totalW = szIcon.cx + m_nIconTextGap + szText.cx;
        int startX = (rc.Width() - totalW) / 2 + rc.left;
        int centerY = (rc.Height() - max(szIcon.cy, szText.cy)) / 2 + rc.top;

        // 繪製圖標
        if (m_hIcon)
            ::DrawIconEx(dc.m_hDC, startX, centerY, m_hIcon, 16, 16, 0, NULL, DI_NORMAL);

        // 繪製文字
        int textX = startX + szIcon.cx + m_nIconTextGap;
        dc.SetBkMode(TRANSPARENT);
        dc.SetTextColor(state & ODS_DISABLED ? GetSysColor(COLOR_GRAYTEXT) : GetSysColor(COLOR_BTNTEXT));
        dc.TextOut(textX, centerY + (szIcon.cy - szText.cy)/2, m_strText);

        dc.Detach();
    }
};

常見問題排查

資源管理最佳實踐

• LoadIcon 加載的圖標：系統自動管理，**絕不可調用 DestroyIcon**，否則導致雙重釋放崩潰
• LoadImage 加載：若使用 LoadImage(..., LR_DEFAULTSIZE | LR_SHARED) 同樣由系統管理
• 手動創建/複製：CopyIcon、CreateIconFromResource 等創建的句柄，**必須調用 DestroyIcon** 釋放
• 按鈕設置後：SetIcon 不轉移所有權，原 HICON 生命周期不變

總結

MFC 按鈕設置圖標的核心是：獲取控件指針 → 設置 BS_ICON 風格 → 加載 HICON → 調用 SetIcon。三種加載方法中，**AfxGetApp()->LoadIconW 最符合 MFC 習慣**，LoadIconW 配合 MAKEINTRESOURCE 最標準通用。進階組合顯示需自繪或位圖按鈕。牢記圖標資源管理規則，避免內存錯誤。