MFC CCheckListBox 使用必讀：Owner-Draw 模式與樣式設定避坑指南

快速上手

1. 對話框拖入 List Box 控制項，ID 設為 IDC_LIST1
類別向導新增控制變數 m_List，類型 CListBox
2. 手動修改標頭檔：CCheckListBox m_List;
3. 關鍵：資源檔 (.rc) 中加入 Owner-Draw 樣式

   
   LISTBOX IDC_LIST1, 160, 133, 153, 84,
       LBS_OWNERDRAWFIXED | LBS_HASSTRINGS | LBS_NOINTEGRALHEIGHT |
       NOT WS_BORDER | WS_VSCROLL | WS_TABSTOP, WS_EX_STATICEDGE
       

   必須包含 LBS_OWNERDRAWFIXED 或 LBS_OWNERDRAWVARIABLE，否則執行時 ASSERT 失敗崩潰！

為什麼需要 Owner-Draw？

CCheckListBox 繼承自 CListBox，核心繪製邏輯在 DrawItem 中自繪核取方塊與文字。MFC 要求 Owner-Draw 模式下由應用程式負責繪製，因此資源定義必須宣告 Owner-Draw 樣式。

常見錯誤與解法

替代方案：動態修改樣式 (無需改 .rc)

void CMyDlg::DoDataExchange(CDataExchange* pDX) {
    CDialog::DoDataExchange(pDX);
    DDX_Control(pDX, IDC_LIST1, m_List);
}

BOOL CMyDlg::OnInitDialog() {
    CDialog::OnInitDialog();
    // 在子類別化後、視窗建立前修改樣式
    m_List.ModifyStyle(0, LBS_OWNERDRAWFIXED | LBS_HASSTRINGS);
    return TRUE;
}

注意：ModifyStyle 必須在 SubclassDlgItem (由 DDX_Control 內部呼叫) 之後、視窗實際建立 (Create) 之前生效。若已建立視窗需呼叫 SetWindowLong(GWL_STYLE, ...) 並 SetWindowPos(..., SWP_FRAMECHANGED) 重繪。

完整範例：加入項目與取得勾選狀態

void CMyDlg::OnBtnAdd() {
    int idx = m_List.AddString(_T("項目 1"));
    m_List.SetCheck(idx, BST_UNCHECKED); // 0=未勾, 1=勾選, 2=不確定
}

void CMyDlg::OnBtnGet() {
    CString str;
    for (int i = 0; i < m_List.GetCount(); ++i) {
        str.Format(_T("項目 %d: %s"), i, m_List.GetCheck(i) ? _T("☑") : _T("☐"));
        AfxMessageBox(str);
    }
}

總結

• CCheckListBox = CListBox + 自繪核取方塊
• 必要條件：資源或執行期樣式含 LBS_OWNERDRAWFIXED 或 LBS_OWNERDRAWVARIABLE
• 視覺設計器不支援直接拖放，需「先建 CListBox 變數 → 手動改型別」
• 動態修改樣式用 ModifyStyle (OnInitDialog) 或 SetWindowLong (已建立視窗)

1. 上一篇文章： VC++ /GS 編譯器開關：緩衝區溢位防護原理與最佳實踐
2. 下一篇文章： VC++ 純 API 繪圖小程式：旋轉風車動畫 (Win32 SDK 風格)

關於VC++

VC++ 樹狀控件節點拖曳完美實作：CXTreeCtrl 完整原始碼解析

前言 MFC CTreeCtrl 原生不支援節點拖曳排序。本

在 MDI 程式中實現類似 WPS 2000 的文件切換標籤

使用過 WPS 2000 的開發者一定對其文件切換功能印象深

MFC 浮動視窗架構下的 OpenGL 多視圖渲染實作

專案需求與架構概覽 工程應用需在可停駐/浮動視窗中同時顯示三

VC++ 列表控件驅動屬性表 (CMyPropertySheet)

前言 MFC CPropertySheet 預設使用 CTa