簡介這份資源面向在 VS2008SP1 環(huán)境下使用 VC 開發(fā)界面的程序員聚焦復(fù)選下拉框CCheckComboBox的實(shí)現(xiàn)與使用。核心文件 CheckComboBox.h 與 CheckComboBox.cpp 封裝了復(fù)選下拉框的完整功能可直接集成到 MFC 項(xiàng)目中。作者 margin 在使用中發(fā)現(xiàn)該控件在模態(tài)子對話框中多次進(jìn)入后會出現(xiàn)無法正常選擇的問題并給出改用非模態(tài)子對話框即可規(guī)避的排錯思路對遇到同類界面交互問題的開發(fā)者有實(shí)際參考價值。資源包共 22 個文件以 8 個 h 頭文件、6 個 cpp 源文件為主另含 sln、vcproj 工程文件及 ico、rc、rc2 等資源文件整體約 136KB工程結(jié)構(gòu)完整便于直接編譯調(diào)試。目前已有 950 人學(xué)習(xí)下載適合需要快速掌握復(fù)選下拉框用法并規(guī)避模態(tài)對話框陷阱的 VC 開發(fā)者參考。1. 復(fù)選下拉框一個被低估的 MFC 控件缺口如果你在 VS2008SP1 的 VC 環(huán)境里做過配置面板、篩選器或者權(quán)限勾選界面大概率遇到過同一個尷尬MFC 自帶的CComboBox只能單選想多選就得自己拼一個「編輯框 列表框 彈出按鈕」的組合或者干脆退化成一組 CheckBox 堆在對話框上。前者交互別扭后者占地方。CCheckComboBox這個資源解決的正是這個缺口——它把下拉列表里的每一項(xiàng)變成帶復(fù)選框的條目點(diǎn)一下切換勾選狀態(tài)收起后還能把已選項(xiàng)拼成文本回顯到編輯區(qū)。適合誰正在維護(hù) VS2008SP1 老項(xiàng)目、不想引入第三方 UI 庫、又需要多選下拉交互的 VC 開發(fā)者。下面我按「它怎么長出來的 → 怎么塞進(jìn)你的工程 → 哪些地方會翻車」拆一遍。2. 拆開看CCheckComboBox 的繼承鏈與消息模型2.1 為什么是「繼承 CComboBox」而不是「組合 CComboBox」常見做法有兩種一種是把CComboBox當(dāng)成員變量組合進(jìn)來另一種是直接繼承。這個資源走的是繼承路線原因很實(shí)際——繼承之后你原來的DDX_Control綁定、GetDlgItem調(diào)用、EnableWindow這些代碼幾乎不用改控件在對話框資源里仍然是一個普通的 ComboBox只是類換成了CCheckComboBox。組合方案則要在外層再包一層窗口過程消息轉(zhuǎn)發(fā)寫起來啰嗦還容易在WM_COMMAND反射上踩坑。繼承鏈大致是CCheckComboBox : public CComboBox。它沒有去動 ComboBox 的繪制底層而是利用 ComboBox 的CBS_DROPDOWNLIST或CBS_DROPDOWN風(fēng)格在列表彈出時接管列表項(xiàng)的繪制和點(diǎn)擊。核心思路是ComboBox 的列表部分本質(zhì)上是一個 ListBox通過GetComboBoxInfo拿到列表窗口句柄然后對列表窗口做自繪Owner Draw或者子類化處理。2.2 復(fù)選框狀態(tài)存在哪一個容易被忽略的設(shè)計(jì)點(diǎn)多選控件最怕狀態(tài)丟失。CCheckComboBox通常用一個DWORD或std::vectorBOOL來保存每一項(xiàng)的勾選狀態(tài)索引與 ComboBox 的 item index 一一對應(yīng)。這里有個關(guān)鍵約束一旦你調(diào)用ResetContent或DeleteString狀態(tài)數(shù)組必須同步維護(hù)否則索引錯位勾選會「漂移」到別的條目上。我見過不止一個項(xiàng)目在這里翻車——動態(tài)刷新列表后用戶明明勾了 A結(jié)果 B 被選上了。狀態(tài)與顯示是分離的列表項(xiàng)文本只負(fù)責(zé)展示勾選狀態(tài)由獨(dú)立數(shù)組管理。收起時控件遍歷狀態(tài)數(shù)組把已勾選項(xiàng)的文本用分隔符默認(rèn)逗號拼起來SetWindowText到編輯區(qū)。這個「拼文本」的邏輯通常暴露一個SetSeparator之類的接口方便你換成中文頓號或分號。2.3 消息映射里必須處理的三個通知要讓復(fù)選框真正響應(yīng)點(diǎn)擊消息映射里至少得掛上這幾類處理// 在 CCheckComboBox 的消息映射中 BEGIN_MESSAGE_MAP(CCheckComboBox, CComboBox) ON_CONTROL_REFLECT(CBN_DROPDOWN, CCheckComboBox::OnDropDown) ON_CONTROL_REFLECT(CBN_SELCHANGE, CCheckComboBox::OnSelChange) ON_CONTROL_REFLECT(CBN_CLOSEUP, CCheckComboBox::OnCloseUp) END_MESSAGE_MAP()CBN_DROPDOWN列表即將彈出此時適合做列表窗口的子類化或自繪準(zhǔn)備。CBN_SELCHANGE用戶在列表中移動選擇項(xiàng)。注意這里不是「勾選」只是高亮移動。真正的勾選切換通常要在CBN_SELCHANGE里判斷并翻轉(zhuǎn)狀態(tài)然后立刻刷新列表項(xiàng)顯示。CBN_CLOSEUP列表收起觸發(fā)文本回顯邏輯把當(dāng)前勾選狀態(tài)拼成字符串。提示CBN_SELCHANGE在鍵盤上下鍵移動時也會觸發(fā)如果你在這里直接翻轉(zhuǎn)勾選鍵盤導(dǎo)航會變成「一路走一路勾」。常見做法是區(qū)分鼠標(biāo)點(diǎn)擊和鍵盤選擇或者干脆用NM_CLICK在列表窗口上單獨(dú)處理鼠標(biāo)。2.4 自繪列表項(xiàng)DrawItem 與 MeasureItem如果走 Owner Draw 路線列表的DrawItem和MeasureItem必須成對實(shí)現(xiàn)。MeasureItem決定每一項(xiàng)的高度復(fù)選框圖標(biāo)通常 16x16加上文字行高一般設(shè) 18~20 像素。DrawItem里先畫復(fù)選框狀態(tài)勾選/未勾選/禁用再畫文本最后處理高亮背景。void CCheckComboBox::DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct) { CDC dc; dc.Attach(lpDrawItemStruct-hDC); CRect rcItem lpDrawItemStruct-rcItem; int nIndex lpDrawItemStruct-itemID; // 根據(jù)狀態(tài)數(shù)組決定復(fù)選框是否勾選 BOOL bChecked m_arrCheck[nIndex]; // 繪制背景選中項(xiàng)高亮 if (lpDrawItemStruct-itemState ODS_SELECTED) dc.FillSolidRect(rcItem, ::GetSysColor(COLOR_HIGHLIGHT)); else dc.FillSolidRect(rcItem, ::GetSysColor(COLOR_WINDOW)); // 繪制復(fù)選框方框與勾 CRect rcCheck rcItem; rcCheck.left 2; rcCheck.right rcCheck.left 16; dc.DrawFrameControl(rcCheck, DFC_BUTTON, bChecked ? DFCS_BUTTONCHECK | DFCS_CHECKED : DFCS_BUTTONCHECK); // 繪制文本 CString strText; GetLBText(nIndex, strText); dc.SetBkMode(TRANSPARENT); dc.SetTextColor((lpDrawItemStruct-itemState ODS_SELECTED) ? ::GetSysColor(COLOR_HIGHLIGHTTEXT) : ::GetSysColor(COLOR_WINDOWTEXT)); rcItem.left rcCheck.right 4; dc.DrawText(strText, rcItem, DT_LEFT | DT_VCENTER | DT_SINGLELINE); dc.Detach(); }邏輯說明lpDrawItemStruct-itemID是當(dāng)前繪制的列表項(xiàng)索引直接用來查狀態(tài)數(shù)組。ODS_SELECTED表示該項(xiàng)當(dāng)前被高亮不是被勾選——高亮和勾選是兩回事別混。DrawFrameControl是 Win32 自帶的復(fù)選框繪制省得自己畫勾。參數(shù)說明DFCS_BUTTONCHECK畫空框加DFCS_CHECKED畫勾選態(tài)。如果你要支持三態(tài)灰選還得加DFCS_BUTTON3STATE和DFCS_INACTIVE但多數(shù)業(yè)務(wù)場景用不上。3. 塞進(jìn) VS2008SP1 工程從添加文件到對話框綁定3.1 文件清單與工程配置拿到資源后通常包含CheckComboBox.h和CheckComboBox.cpp兩個文件。在 VS2008SP1 里右鍵工程 → 添加 → 現(xiàn)有項(xiàng)把這兩個文件加進(jìn)去。如果你的工程用了預(yù)編譯頭stdafx.h確保.cpp文件第一行包含它否則會報一堆a(bǔ)fxwin.h找不到的錯。文件作用是否必須CheckComboBox.h類聲明、消息映射、接口定義是CheckComboBox.cpp繪制、狀態(tài)管理、消息處理實(shí)現(xiàn)是CheckComboBoxDemo示例對話框工程否參考用注意VS2008SP1 的 MFC 版本對ON_CONTROL_REFLECT的支持沒問題但如果你從更高版本VS2010拿到的代碼可能用了nullptr、override這些 C11 關(guān)鍵字直接編譯會報錯。常見做法是手動替換成NULL和去掉override。3.2 對話框資源里的替換步驟假設(shè)你已經(jīng)在對話框資源里放了一個 ComboBoxID 為IDC_COMBO_FILTER。右鍵 → 添加變量變量類型填CCheckComboBox變量名比如m_comboFilter。如果類列表里沒有CCheckComboBox說明頭文件沒被包含進(jìn)對話框的頭文件手動加一行#include CheckComboBox.h。然后確認(rèn) ComboBox 的屬性Type 設(shè)為Dropdown或Drop ListOwner Draw設(shè)為Fixed或Variable。如果資源里沒設(shè) Owner Draw自繪不會生效列表項(xiàng)還是默認(rèn)的單行文本。// 在對話框的 OnInitDialog 中初始化 BOOL CMyDlg::OnInitDialog() { CDialogEx::OnInitDialog(); // 添加帶復(fù)選框的條目 m_comboFilter.AddString(_T(按狀態(tài)篩選)); m_comboFilter.AddString(_T(按時間篩選)); m_comboFilter.AddString(_T(按關(guān)鍵字篩選)); // 默認(rèn)勾選第一項(xiàng) m_comboFilter.SetCheck(0, TRUE); // 設(shè)置分隔符為中文頓號 m_comboFilter.SetSeparator(_T(、)); return TRUE; }邏輯說明AddString是繼承自CComboBox的方法添加條目的同時CCheckComboBox內(nèi)部會把狀態(tài)數(shù)組擴(kuò)容并默認(rèn)置為未勾選。SetCheck是新增接口第一個參數(shù)是索引第二個是勾選狀態(tài)。SetSeparator決定收起后文本的拼接方式。參數(shù)說明SetCheck的索引必須小于條目總數(shù)否則可能越界。如果你在AddString之前調(diào)用SetCheck狀態(tài)數(shù)組還沒分配會直接崩。順序不能反。3.3 讀取勾選結(jié)果別用 GetCurSel這是最容易踩的坑。CComboBox::GetCurSel返回的是當(dāng)前高亮項(xiàng)不是勾選項(xiàng)。多選場景下高亮項(xiàng)可能一個都沒勾也可能勾了好幾個但高亮停在別處。正確做法是遍歷狀態(tài)數(shù)組// 獲取所有已勾選項(xiàng)的索引 std::vectorint CMyDlg::GetCheckedIndices() { std::vectorint vecChecked; int nCount m_comboFilter.GetCount(); for (int i 0; i nCount; i) { if (m_comboFilter.GetCheck(i)) vecChecked.push_back(i); } return vecChecked; }邏輯說明GetCheck(i)返回第 i 項(xiàng)的勾選狀態(tài)。遍歷全部條目收集為真的索引。如果你需要文本而不是索引把GetCheck換成先判斷再GetLBText。參數(shù)說明GetCount返回條目總數(shù)循環(huán)邊界用它不要硬編碼。如果列表是動態(tài)增刪的每次讀取前重新GetCount別緩存舊值。4. 避坑與排查五個真實(shí)翻車現(xiàn)場4.1 現(xiàn)象列表項(xiàng)點(diǎn)擊后勾選狀態(tài)閃一下就沒了原因在CBN_SELCHANGE里翻轉(zhuǎn)了狀態(tài)但緊接著 ComboBox 默認(rèn)處理又把選擇項(xiàng)重置或者DrawItem里讀的狀態(tài)數(shù)組和寫入的不是同一份。常見于狀態(tài)數(shù)組用了局部變量或者拷貝構(gòu)造沒處理好。解決確認(rèn)狀態(tài)數(shù)組是類的成員變量且在AddString重寫里同步擴(kuò)容。翻轉(zhuǎn)狀態(tài)后調(diào)用Invalidate刷新列表不要依賴 ComboBox 的默認(rèn)重繪。4.2 現(xiàn)象收起后編輯區(qū)顯示的是最后點(diǎn)擊項(xiàng)不是所有勾選項(xiàng)原因文本回顯邏輯寫在了CBN_SELCHANGE里而不是CBN_CLOSEUP。CBN_SELCHANGE每次高亮移動都觸發(fā)此時拼文本只能拿到當(dāng)前項(xiàng)。解決把拼文本的邏輯挪到CBN_CLOSEUP或者單獨(dú)寫一個UpdateText函數(shù)在勾選狀態(tài)變化后和收起時都調(diào)用。4.3 現(xiàn)象VS2008SP1 編譯報錯「error C2065: nullptr 未聲明的標(biāo)識符」原因資源代碼來自更高版本的 Visual Studio用了 C11 關(guān)鍵字。VS2008SP1 默認(rèn)只支持到 C03。解決全局搜索nullptr替換為NULL搜索override直接刪除搜索auto檢查是否用了類型推導(dǎo)VS2008 不支持auto推導(dǎo)。如果代碼里用了std::unique_ptr換成std::auto_ptr或者裸指針加手動delete。4.4 現(xiàn)象下拉列表彈出來后復(fù)選框畫出來了但點(diǎn)擊沒反應(yīng)原因列表窗口沒有被子類化鼠標(biāo)點(diǎn)擊消息被 ComboBox 默認(rèn)的列表窗口過程吃掉了沒走到你的處理函數(shù)。解決在OnDropDown里通過GetComboBoxInfo拿到hwndList然后SubclassWindow或者SetWindowLongPtr掛上自己的窗口過程。注意保存舊的窗口過程指針處理完不關(guān)心的消息要轉(zhuǎn)發(fā)回去。4.5 現(xiàn)象動態(tài)增刪條目后勾選狀態(tài)錯位原因DeleteString刪除條目時狀態(tài)數(shù)組沒有同步刪除對應(yīng)索引后面的狀態(tài)整體前移導(dǎo)致原本勾選第 3 項(xiàng)變成了勾選第 2 項(xiàng)。解決重寫DeleteString在調(diào)用基類刪除之前先m_arrCheck.erase(m_arrCheck.begin() nIndex)。如果一次性清空用ResetContent重寫把狀態(tài)數(shù)組也clear。5. 進(jìn)階把勾選結(jié)果持久化到配置與一個驗(yàn)證習(xí)慣多選控件的價值最終要落到「用戶選了什么下次打開還在」。我一般會在對話框的OnOK里把勾選索引序列化成字符串寫進(jìn)注冊表或 ini 文件。序列化格式用逗號分隔的索引列表比如0,2,5讀取時解析回std::vectorint再逐項(xiàng)SetCheck。// 保存勾選狀態(tài)到 ini void CMyDlg::SaveCheckedState() { std::vectorint vecChecked GetCheckedIndices(); CString strValue; for (size_t i 0; i vecChecked.size(); i) { CString strIndex; strIndex.Format(_T(%d), vecChecked[i]); if (!strValue.IsEmpty()) strValue _T(,); strValue strIndex; } WritePrivateProfileString(_T(Filter), _T(Checked), strValue, _T(.\\config.ini)); } // 從 ini 恢復(fù)勾選狀態(tài) void CMyDlg::LoadCheckedState() { TCHAR szBuf[256] {0}; GetPrivateProfileString(_T(Filter), _T(Checked), _T(), szBuf, 256, _T(.\\config.ini)); CString strBuf(szBuf); int nPos 0; CString strToken strBuf.Tokenize(_T(,), nPos); while (!strToken.IsEmpty()) { int nIndex _ttoi(strToken); if (nIndex 0 nIndex m_comboFilter.GetCount()) m_comboFilter.SetCheck(nIndex, TRUE); strToken strBuf.Tokenize(_T(,), nPos); } }邏輯說明Tokenize按逗號切分_ttoi轉(zhuǎn)成整數(shù)邊界檢查防止 ini 被手改后越界。SetCheck只置勾選不改變高亮項(xiàng)所以恢復(fù)后編輯區(qū)文本需要手動調(diào)一次UpdateText或者觸發(fā)CBN_CLOSEUP的邏輯。參數(shù)說明WritePrivateProfileString和GetPrivateProfileString是 Win32 API路徑用相對路徑時注意工作目錄建議用GetModuleFileName拼絕對路徑避免從不同快捷方式啟動時讀寫到不同文件。驗(yàn)證方法我習(xí)慣在SetCheck之后加一個斷言確認(rèn)索引在合法范圍內(nèi)在GetCheckedIndices返回后打印一遍索引列表和界面上肉眼看到的勾選做比對。這個習(xí)慣幫我逮住過好幾次「狀態(tài)數(shù)組和列表項(xiàng)數(shù)量不一致」的玄學(xué)問題——表面看勾選正常實(shí)際數(shù)組已經(jīng)越界讀到了臟數(shù)據(jù)。從那以后我每次集成這類自繪控件都強(qiáng)制走一遍「添加條目 → 勾選 → 收起 → 重新打開 → 動態(tài)刪除條目 → 再勾選」的完整鏈路確認(rèn)狀態(tài)數(shù)組和界面始終對齊。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取