器與列表框?qū)嵅伲簩?shí)現(xiàn)Windows桌面應(yīng)用動(dòng)態(tài)刷新)
在開發(fā) Windows 桌面應(yīng)用時(shí)經(jīng)常需要讓界面“自己動(dòng)起來”——比如每隔一秒刷新一次狀態(tài)、持續(xù)采集設(shè)備數(shù)據(jù)并顯示在列表里、或者在日志列表里自動(dòng)追加新記錄。很多新手最容易想到的做法是寫一個(gè)while(1)循環(huán)不斷更新控件結(jié)果窗口直接卡死鼠標(biāo)轉(zhuǎn)圈。其實(shí)在 MFC 里有一個(gè)非常輕量的解決思路就是用定時(shí)器配合列表框完成間歇性刷新。這篇文章就是圍繞“添加定時(shí)器更新列表框內(nèi)容”這個(gè)實(shí)戰(zhàn)場(chǎng)景展開的。我會(huì)從概念講起再逐步帶你完成一個(gè)可運(yùn)行的 MFC 示例程序。內(nèi)容包括定時(shí)器如何創(chuàng)建和銷毀、WM_TIMER消息怎么處理、CListBox控件如何添加和刪除數(shù)據(jù)、以及實(shí)際開發(fā)中最容易踩到的坑。適合剛開始接觸 MFC 的讀者也適合需要快速實(shí)現(xiàn)定時(shí)刷新功能的開發(fā)者。1. 定時(shí)器與列表框的基礎(chǔ)概念1.1 定時(shí)器是什么在 Windows 編程里定時(shí)器不是硬件定時(shí)器也不是高精度計(jì)時(shí)器而是一個(gè)基于消息機(jī)制的軟件定時(shí)工具。你告訴系統(tǒng)“每 1000 毫秒通知我一次”系統(tǒng)就會(huì)在到達(dá)時(shí)間后把一條WM_TIMER消息投遞到你的窗口消息隊(duì)列里。MFC 把這個(gè)機(jī)制封裝得很簡單調(diào)用SetTimer創(chuàng)建定時(shí)器重寫OnTimer接收消息調(diào)用KillTimer銷毀定時(shí)器。整個(gè)流程對(duì)開發(fā)者來說非常直觀。需要注意的是WM_TIMER消息的優(yōu)先級(jí)比較低只有在消息隊(duì)列中沒有其他更高優(yōu)先級(jí)消息時(shí)才會(huì)被處理。所以定時(shí)器的實(shí)際觸發(fā)間隔會(huì)受到系統(tǒng)繁忙程度的影響不適合用在需要精確計(jì)時(shí)的場(chǎng)合。1.2 列表框ListBox的作用列表框是一個(gè)大家都很熟悉的 Windows 標(biāo)準(zhǔn)控件用于顯示一列文本條目。在 MFC 中它對(duì)應(yīng)CListBox類常用方法包括AddString在末尾添加一個(gè)字符串。InsertString在指定位置插入字符串。DeleteString刪除指定索引的字符串。ResetContent清空所有項(xiàng)。GetCount獲取當(dāng)前條目數(shù)量。當(dāng)我們要?jiǎng)討B(tài)展示不斷產(chǎn)生的數(shù)據(jù)時(shí)列表框是非常直觀的容器。1.3 為什么要把兩者結(jié)合定時(shí)器負(fù)責(zé)“產(chǎn)數(shù)據(jù)”列表框負(fù)責(zé)“展示數(shù)據(jù)”。比如你要做一個(gè)環(huán)境溫度實(shí)時(shí)監(jiān)測(cè)工具定時(shí)器每隔 1 秒讀取一次溫度值然后把溫度字符串添加到列表框中屏幕上就能看到一條條不斷滾動(dòng)的記錄。這種組合方式既避免了手動(dòng)刷新界面的繁瑣操作又不會(huì)因?yàn)楦哳l刷新導(dǎo)致程序卡頓。它會(huì)成為你編寫上位機(jī)、小工具、日志監(jiān)控程序時(shí)的常用套路。2. 環(huán)境準(zhǔn)備與項(xiàng)目說明2.1 開發(fā)環(huán)境本文示例以 Microsoft Visual Studio 為開發(fā)環(huán)境。版本可以是 VS2017、VS2019 或 VS2022操作步驟基本一致。項(xiàng)目類型選擇“MFC 應(yīng)用程序”在向?qū)е羞x擇“基于對(duì)話框”。需要提前安裝的組件是使用 C 的桌面開發(fā)適用于最新 v143 生成工具的 C MFCx86 和 x64如果你在安裝 Visual Studio 時(shí)沒有勾選 MFC 組件可以打開“Visual Studio Installer”選擇“修改”然后勾選對(duì)應(yīng)組件即可。2.2 創(chuàng)建 MFC 對(duì)話框項(xiàng)目打開 Visual Studio按下面步驟創(chuàng)建項(xiàng)目選擇“創(chuàng)建新項(xiàng)目”。搜索“MFC”選擇“MFC 應(yīng)用程序”。項(xiàng)目名稱可以命名為TimerListDemo。點(diǎn)擊“創(chuàng)建”進(jìn)入 MFC 應(yīng)用程序向?qū)?。在“?yīng)用程序類型”中選擇“基于對(duì)話框”。其他選項(xiàng)保持默認(rèn)點(diǎn)擊“完成”。此時(shí)Visual Studio 會(huì)為你生成一個(gè)最基本的對(duì)話框程序。項(xiàng)目中有兩個(gè)核心類CTimerListDemoApp應(yīng)用程序類負(fù)責(zé)程序啟動(dòng)。CTimerListDemoDlg對(duì)話框類負(fù)責(zé)界面邏輯。我們要寫的代碼基本上都在CTimerListDemoDlg這個(gè)類里。2.3 界面布局設(shè)計(jì)打開資源視圖找到對(duì)話框資源IDD_TIMERLISTDEMO_DIALOG。在工具箱中拖入一個(gè)按鈕和一個(gè)列表框。為了演示方便我們?cè)O(shè)計(jì)兩個(gè)按鈕IDC_BTN_START標(biāo)題為“啟動(dòng)定時(shí)器”IDC_BTN_STOP標(biāo)題為“停止定時(shí)器”IDC_LIST_LOG一個(gè) ListBox 控件界面大致如下[ 啟動(dòng)定時(shí)器 ] [ 停止定時(shí)器 ] [ 列表框顯示日志 ]這個(gè)布局最簡單也最容易理解。你還可以在按鈕下面加一個(gè)靜態(tài)文本用來顯示當(dāng)前狀態(tài)不過那不是本次重點(diǎn)。3. MFC 定時(shí)器的工作原理3.1 SetTimer 函數(shù)SetTimer用來創(chuàng)建一個(gè)定時(shí)器它有四種重載形式。我們先看最常用的一種UINT_PTR SetTimer( UINT_PTR nIDEvent, UINT nElapse, void (CALLBACK* lpfnTimer)(HWND, UINT, UINT_PTR, DWORD) nullptr );參數(shù)含義如下nIDEvent定時(shí)器 ID。我們可以在一個(gè)窗口中創(chuàng)建多個(gè)定時(shí)器通過 ID 區(qū)分它們。nElapse觸發(fā)間隔單位是毫秒。比如 1000 表示每隔 1 秒觸發(fā)一次。lpfnTimer回調(diào)函數(shù)指針。通常傳nullptr這樣定時(shí)器消息會(huì)發(fā)送到窗口的OnTimer消息處理函數(shù)中。在 MFC 中我們通常寫SetTimer(1, 1000, nullptr);這條語句的意思是創(chuàng)建一個(gè) ID 為 1 的定時(shí)器每 1000 毫秒觸發(fā)一次。如果返回值非零說明創(chuàng)建成功。3.2 KillTimer 函數(shù)當(dāng)不再需要定時(shí)器時(shí)必須調(diào)用KillTimer來銷毀它避免資源泄漏。KillTimer(1);參數(shù)就是定時(shí)器 ID。銷毀之后窗口中不再收到該 ID 對(duì)應(yīng)的WM_TIMER消息。3.3 WM_TIMER 消息與 ON_WM_TIMER 宏當(dāng)定時(shí)器的時(shí)間到了之后系統(tǒng)會(huì)把WM_TIMER消息發(fā)送到創(chuàng)建定時(shí)器的窗口。在 MFC 中我們需要在消息映射中加入ON_WM_TIMER()宏并在對(duì)話框類中聲明和實(shí)現(xiàn)OnTimer函數(shù)。消息映射部分如下BEGIN_MESSAGE_MAP(CTimerListDemoDlg, CDialogEx) ON_WM_TIMER() ON_BN_CLICKED(IDC_BTN_START, CTimerListDemoDlg::OnBnClickedBtnStart) ON_BN_CLICKED(IDC_BTN_STOP, CTimerListDemoDlg::OnBnClickedBtnStop) END_MESSAGE_MAP()OnTimer函數(shù)的原型是void OnTimer(UINT_PTR nIDEvent);在這個(gè)函數(shù)內(nèi)部我們可以根據(jù)nIDEvent判斷當(dāng)前是哪一號(hào)定時(shí)器觸發(fā)了。4. 完整實(shí)現(xiàn)定時(shí)更新列表框下面進(jìn)入核心部分。我會(huì)按照文件位置一步步寫清楚保證代碼可以直接復(fù)制到你的項(xiàng)目中。4.1 添加控件變量在對(duì)話框頭文件TimerListDemoDlg.h中為列表框添加一個(gè)關(guān)聯(lián)變量。按CtrlShiftX打開類向?qū)г凇俺蓡T變量”選項(xiàng)卡中選擇控件 IDIDC_LIST_LOG點(diǎn)擊“添加變量”。我們將其命名為m_listLog類別選擇Control變量類型選擇CListBox。添加完成后頭文件中會(huì)多出這樣一行// 文件路徑TimerListDemoDlg.h public: CListBox m_listLog;另外我們還需要一個(gè)計(jì)數(shù)器成員變量用來記錄當(dāng)前是第幾次插入數(shù)據(jù)。手動(dòng)在頭文件類定義中添加public: int m_nCount 0;4.2 添加按鈕點(diǎn)擊事件在資源視圖中雙擊“啟動(dòng)定時(shí)器”按鈕VS 會(huì)自動(dòng)生成點(diǎn)擊事件處理函數(shù)。雙擊“停止定時(shí)器”按鈕也會(huì)自動(dòng)生成對(duì)應(yīng)的函數(shù)。生成的函數(shù)位于TimerListDemoDlg.cpp中void CTimerListDemoDlg::OnBnClickedBtnStart() { // TODO: 在此添加控件通知處理程序代碼 } void CTimerListDemoDlg::OnBnClickedBtnStop() { // TODO: 在此添加控件通知處理程序代碼 }我們將在下一步分別實(shí)現(xiàn)“啟動(dòng)”和“停止”邏輯。4.3 在 OnInitDialog 中初始化OnInitDialog是對(duì)話框初始化函數(shù)程序啟動(dòng)時(shí)會(huì)執(zhí)行到這里。我們可以在這里設(shè)置一些初始狀態(tài)比如讓“停止定時(shí)器”按鈕在開始時(shí)不可用。在TimerListDemoDlg.cpp的OnInitDialog中找到return TRUE;之前添加如下代碼BOOL CTimerListDemoDlg::OnInitDialog() { CDialogEx::OnInitDialog(); // 其他初始化代碼... // 初始化界面 GetDlgItem(IDC_BTN_STOP)-EnableWindow(FALSE); m_nCount 0; return TRUE; // 除非將焦點(diǎn)設(shè)置到控件否則返回 TRUE }這里我們用GetDlgItem(IDC_BTN_STOP)-EnableWindow(FALSE);讓“停止”按鈕初始不可用避免程序一啟動(dòng)就誤點(diǎn)擊。4.4 啟動(dòng)定時(shí)器在“啟動(dòng)定時(shí)器”按鈕的點(diǎn)擊事件中調(diào)用SetTimer同時(shí)更新按鈕狀態(tài)。void CTimerListDemoDlg::OnBnClickedBtnStart() { // 創(chuàng)建定時(shí)器ID 為 1間隔 1000 毫秒 BOOL bRet SetTimer(1, 1000, nullptr); if (bRet) { // 啟動(dòng)成功更新按鈕狀態(tài) GetDlgItem(IDC_BTN_START)-EnableWindow(FALSE); GetDlgItem(IDC_BTN_STOP)-EnableWindow(TRUE); } }注意這里我把SetTimer的返回值賦給了BOOL類型變量。在 MFC 中SetTimer返回值為定時(shí)器 ID非零表示成功。用BOOL接收是可行的但更準(zhǔn)確的寫法是UINT_PTR nTimerID SetTimer(1, 1000, nullptr); if (nTimerID ! 0) { // 啟動(dòng)成功 }為了保持代碼直觀下面我們都用布爾判斷方式。4.5 編寫 OnTimer 處理函數(shù)現(xiàn)在是最關(guān)鍵的一步。我們需要在對(duì)話框類中添加OnTimer函數(shù)。如果項(xiàng)目中還沒有ON_WM_TIMER()消息映射你可以在類向?qū)е惺謩?dòng)添加。最簡單的方式是在類視圖中選中CTimerListDemoDlg在屬性窗口頂部點(diǎn)擊“消息”圖標(biāo)找到WM_TIMER添加處理函數(shù)OnTimer。添加后VS 會(huì)自動(dòng)在頭文件和源文件里生成函數(shù)聲明與實(shí)現(xiàn)框架。我們直接在里面填寫邏輯void CTimerListDemoDlg::OnTimer(UINT_PTR nIDEvent) { if (nIDEvent 1) { // 每觸發(fā)一次計(jì)數(shù)器加 1 m_nCount; // 生成一條包含計(jì)數(shù)值的字符串 CString strText; strText.Format(_T(記錄 %d第 %d 次刷新), m_nCount, m_nCount); // 添加到列表框 m_listLog.AddString(strText); // 如果條目過多自動(dòng)刪除最舊的一條保持列表只顯示最近 100 條 if (m_listLog.GetCount() 100) { m_listLog.DeleteString(0); } } CDialogEx::OnTimer(nIDEvent); }這段代碼的含義很容易理解每次定時(shí)器觸發(fā)時(shí)計(jì)數(shù)器加 1。用Format生成格式化字符串。通過AddString把它加到列表框末尾。當(dāng)總數(shù)超過 100 條時(shí)刪除第 0 條最上面的最舊的記錄保證界面不無限增長。4.6 停止定時(shí)器在“停止定時(shí)器”按鈕的點(diǎn)擊事件中調(diào)用KillTimer同時(shí)恢復(fù)按鈕狀態(tài)。void CTimerListDemoDlg::OnBnClickedBtnStop() { // 銷毀定時(shí)器 KillTimer(1); // 更新按鈕狀態(tài) GetDlgItem(IDC_BTN_START)-EnableWindow(TRUE); GetDlgItem(IDC_BTN_STOP)-EnableWindow(FALSE); }這樣用戶就可以隨時(shí)啟動(dòng)和停止定時(shí)器。4.7 在窗口關(guān)閉時(shí)銷毀定時(shí)器我們還需要注意一個(gè)問題如果用戶沒有點(diǎn)擊“停止”按鈕直接關(guān)閉了對(duì)話框窗口那么定時(shí)器仍然存在嗎答案是當(dāng)窗口銷毀時(shí)Windows 會(huì)默認(rèn)銷毀該窗口創(chuàng)建的定時(shí)器所以一般不會(huì)造成嚴(yán)重泄漏。但為了代碼嚴(yán)謹(jǐn)我們可以在OnDestroy消息處理函數(shù)中主動(dòng)銷毀定時(shí)器。打開類向?qū)г趯?duì)話框類中添加WM_DESTROY消息處理函數(shù)OnDestroy然后實(shí)現(xiàn)void CTimerListDemoDlg::OnDestroy() { // 銷毀定時(shí)器 KillTimer(1); CDialogEx::OnDestroy(); }這樣做的好處是即使按鈕狀態(tài)沒有正確保存窗口關(guān)閉時(shí)也會(huì)把定時(shí)器資源清理干凈。4.8 運(yùn)行效果編譯并運(yùn)行程序。點(diǎn)擊“啟動(dòng)定時(shí)器”按鈕后你會(huì)看到列表框里每秒增加一條記錄內(nèi)容類似記錄 1第 1 次刷新 記錄 2第 2 次刷新 記錄 3第 3 次刷新 ...點(diǎn)擊“停止定時(shí)器”列表停止增長。再次點(diǎn)擊“啟動(dòng)定時(shí)器”記錄會(huì)繼續(xù)從上次的計(jì)數(shù)往下增長。這個(gè)小程序就完整跑通了“定時(shí)器 列表框”的聯(lián)動(dòng)邏輯。5. 擴(kuò)展功能多定時(shí)器與數(shù)據(jù)處理實(shí)際項(xiàng)目中一個(gè)窗口往往不止有一個(gè)定時(shí)器。比如一邊定時(shí)刷新傳感器數(shù)據(jù)一邊定時(shí)檢查網(wǎng)絡(luò)連接狀態(tài)。這時(shí)就需要通過不同的 ID 來區(qū)分。5.1 使用多個(gè)定時(shí)器你可以像下面這樣創(chuàng)建兩個(gè)定時(shí)器SetTimer(1, 1000, nullptr); // 秒級(jí)刷新 SetTimer(2, 5000, nullptr); // 5 秒級(jí)刷新然后在OnTimer中分別處理void CTimerListDemoDlg::OnTimer(UINT_PTR nIDEvent) { switch (nIDEvent) { case 1: m_listLog.AddString(_T(1 秒定時(shí)器觸發(fā))); break; case 2: m_listLog.AddString(_T(5 秒定時(shí)器觸發(fā))); break; default: break; } CDialogEx::OnTimer(nIDEvent); }這樣設(shè)計(jì)條理清晰擴(kuò)展起來也很方便。5.2 在列表框中顯示時(shí)間戳如果我們需要在每條記錄前加上當(dāng)前時(shí)間可以使用CTime類void CTimerListDemoDlg::OnTimer(UINT_PTR nIDEvent) { if (nIDEvent 1) { CTime now CTime::GetCurrentTime(); CString strTime now.Format(_T(%H:%M:%S)); m_nCount; CString strText; strText.Format(_T([%s] 第 %d 條刷新數(shù)據(jù)), strTime, m_nCount); m_listLog.AddString(strText); if (m_listLog.GetCount() 100) { m_listLog.DeleteString(0); } } CDialogEx::OnTimer(nIDEvent); }這樣列表里每條記錄都帶上了時(shí)間看起來更像一個(gè)完整的日志系統(tǒng)。5.3 限制列表框容量上面的代碼已經(jīng)展示了限制最大行數(shù)的方式。這里再強(qiáng)調(diào)一下如果功能是持續(xù)采集數(shù)據(jù)不能無限制地向列表框中添加內(nèi)容。每添加一條記錄內(nèi)存占用就會(huì)增加一點(diǎn)。雖然單條字符串很小但長時(shí)間運(yùn)行后數(shù)量會(huì)非常龐大導(dǎo)致程序內(nèi)存暴漲、界面變卡。所以最佳做法是每次添加后判斷總數(shù)超過閾值就刪除最舊的一條索引 0。也可以用下面這種寫法保證列表始終顯示最新的 100 條while (m_listLog.GetCount() 100) { m_listLog.DeleteString(0); } m_listLog.AddString(strText);兩種方式都可以第一種更節(jié)省性能因?yàn)橹辉诔迺r(shí)刪除一次。6. 常見問題與排查思路在實(shí)際開發(fā)中你可能遇到各種奇怪的現(xiàn)象。下面整理了一些高頻問題并給出排查方向。問題現(xiàn)象常見原因解決思路定時(shí)器不觸發(fā)忘記添加ON_WM_TIMER()消息映射檢查消息映射中是否有ON_WM_TIMER()并確認(rèn)OnTimer函數(shù)簽名正確定時(shí)器不觸發(fā)SetTimer調(diào)用失敗檢查返回值確認(rèn)窗口句柄有效確認(rèn)沒有重復(fù)創(chuàng)建相同 ID 導(dǎo)致沖突界面卡死在OnTimer中執(zhí)行了耗時(shí)操作不要在定時(shí)器處理函數(shù)中做耗時(shí)計(jì)算可以放到工作線程中列表框內(nèi)容無限增長沒有限制條目數(shù)量添加后判斷GetCount()超過閾值刪除舊記錄關(guān)閉窗口后程序仍在運(yùn)行OnDestroy中沒有銷毀定時(shí)器重寫WM_DESTROY消息處理調(diào)用KillTimer多個(gè)定時(shí)器互相干擾沒有用nIDEvent區(qū)分為每個(gè)定時(shí)器分配不同的 ID在OnTimer中用switch或if分支處理定時(shí)器間隔不準(zhǔn)系統(tǒng)繁忙或定時(shí)器精度限制使用更低優(yōu)先級(jí)的方式運(yùn)行其它任務(wù)或使用WaitableTimer等高精度定時(shí)器程序剛啟動(dòng)時(shí)列表為空還沒有觸發(fā)定時(shí)器檢查初始化時(shí)是否調(diào)用了SetTimer或者間隔設(shè)置是否過大7. 最佳實(shí)踐與工程建議7.1 定時(shí)器處理函數(shù)不要做耗時(shí)操作OnTimer運(yùn)行在 UI 線程中。如果你在里面寫了大循環(huán)、文件讀寫、網(wǎng)絡(luò)請(qǐng)求界面就無法及時(shí)處理鼠標(biāo)、鍵盤和重繪消息表現(xiàn)出來就是窗口卡死。正確的做法是在OnTimer中只做輕量操作比如從共享變量中讀取數(shù)據(jù)、更新控件。真正的耗時(shí)任務(wù)放到工作線程中完成線程計(jì)算完后再通過自定義消息或PostMessage通知 UI 線程更新。7.2 建議使用成員變量保存定時(shí)器 ID有些例子直接用數(shù)字1來創(chuàng)建和銷毀定時(shí)器這樣寫確實(shí)簡單但工程維護(hù)時(shí)不太友好。更推薦的做法是定義常量或枚舉// 在頭文件中定義 #define TIMER_ID_REFRESH 1 #define TIMER_ID_CHECK 2或者使用enumenum { TIMER_ID_REFRESH 1, TIMER_ID_CHECK 2 };這樣在代碼中看到SetTimer(TIMER_ID_REFRESH, 1000, nullptr)一眼就能明白這個(gè)定時(shí)器的用途也方便后續(xù)添加新定時(shí)器。7.3 使用類向?qū)ЬS護(hù)消息處理函數(shù)雖然可以手動(dòng)在頭文件和源文件中添加OnTimer聲明與實(shí)現(xiàn)但使用向?qū)Ц踩?。向?qū)?huì)自動(dòng)生成正確的消息映射和函數(shù)簽名減少低級(jí)錯(cuò)誤。尤其是初學(xué)者建議在類向?qū)е刑砑覹M_TIMER和WM_DESTROY的處理函數(shù)而不是手動(dòng)復(fù)制網(wǎng)上代碼。這樣可以避免因?yàn)轭^文件格式不一致而導(dǎo)致的編譯錯(cuò)誤。7.4 定時(shí)器間隔不是越小越好有人為了讓界面看起來更“實(shí)時(shí)”把定時(shí)器間隔設(shè)置為 1 毫秒。這在 Windows 消息定時(shí)器上并沒有意義因?yàn)閃M_TIMER消息并不會(huì)保證 1 毫秒觸發(fā)一次而且頻繁觸發(fā)會(huì)讓 UI 線程忙于處理定時(shí)器消息浪費(fèi) CPU。對(duì)于常規(guī)界面刷新100 毫秒到 1000 毫秒是常見的選擇。如果需求是精確測(cè)量時(shí)間或者高頻采樣建議使用多媒體定時(shí)器或高精度事件定時(shí)器。7.5 注意定時(shí)器 ID 沖突同一個(gè)窗口內(nèi)定時(shí)器 ID 必須唯一。如果你在多個(gè)地方都使用SetTimer(1, ...)后者會(huì)覆蓋前者導(dǎo)致前一個(gè)定時(shí)器失效。所以在多模塊協(xié)作時(shí)盡量使用較大的數(shù)字或者枚舉值或者由公共模塊統(tǒng)一分配。7.6 列表框更新后的滾動(dòng)定位當(dāng)列表框條目很多時(shí)AddString會(huì)在最后添加一行但滾動(dòng)條不一定自動(dòng)滾到底部。如果你希望用戶永遠(yuǎn)看到最新一條需要在添加后設(shè)置當(dāng)前選中項(xiàng)并確保它可見int nIndex m_listLog.AddString(strText); m_listLog.SetCurSel(nIndex);如果你使用的是CListBox的默認(rèn)風(fēng)格SetCurSel會(huì)讓選中項(xiàng)高亮同時(shí)自動(dòng)滾動(dòng)到可見區(qū)域。如果你不想顯示選中狀態(tài)可以改用SetTopIndex來調(diào)整滾動(dòng)位置但通常日志場(chǎng)景里允許高亮。8. 最后的經(jīng)驗(yàn)小結(jié)到這里“定時(shí)器 列表框”的完整鏈路已經(jīng)打通了。這個(gè)功能雖然看起來簡單但它背后包含了 Windows 消息機(jī)制、控件操作、資源管理和 UI 線程安全等一系列基礎(chǔ)知識(shí)。以后你再遇到“每隔一段時(shí)間刷新界面”“動(dòng)態(tài)往列表里加數(shù)據(jù)”的需求都可以直接套用這套思路SetTimer創(chuàng)建定時(shí)器OnTimer處理邏輯AddString更新列表框KillTimer釋放資源。把這個(gè)套路練熟后面再學(xué)習(xí)工作線程、自定義消息、數(shù)據(jù)庫輪詢等功能時(shí)會(huì)順利很多。希望這篇文章能幫你解決實(shí)際問題。如果你在運(yùn)行過程中遇到了其他報(bào)錯(cuò)歡迎對(duì)照上面的排查表一步步檢查。動(dòng)手練習(xí)一遍比你只看不做要有效得多。 MFC定時(shí)器與列表框?qū)嵅伲簩?shí)現(xiàn)Windows桌面應(yīng)用動(dòng)態(tài)刷新
在開發(fā) Windows 桌面應(yīng)用時(shí)經(jīng)常需要讓界面“自己動(dòng)起來”——比如每隔一秒刷新一次狀態(tài)、持續(xù)采集設(shè)備數(shù)據(jù)并顯示在列表里、或者在日志列表里自動(dòng)追加新記錄。很多新手最容易想到的做法是寫一個(gè)while(1)循環(huán)不斷更新控件結(jié)果窗口直接卡死鼠標(biāo)轉(zhuǎn)圈。其實(shí)在 MFC 里有一個(gè)非常輕量的解決思路就是用定時(shí)器配合列表框完成間歇性刷新。這篇文章就是圍繞“添加定時(shí)器更新列表框內(nèi)容”這個(gè)實(shí)戰(zhàn)場(chǎng)景展開的。我會(huì)從概念講起再逐步帶你完成一個(gè)可運(yùn)行的 MFC 示例程序。內(nèi)容包括定時(shí)器如何創(chuàng)建和銷毀、WM_TIMER消息怎么處理、CListBox控件如何添加和刪除數(shù)據(jù)、以及實(shí)際開發(fā)中最容易踩到的坑。適合剛開始接觸 MFC 的讀者也適合需要快速實(shí)現(xiàn)定時(shí)刷新功能的開發(fā)者。1. 定時(shí)器與列表框的基礎(chǔ)概念1.1 定時(shí)器是什么在 Windows 編程里定時(shí)器不是硬件定時(shí)器也不是高精度計(jì)時(shí)器而是一個(gè)基于消息機(jī)制的軟件定時(shí)工具。你告訴系統(tǒng)“每 1000 毫秒通知我一次”系統(tǒng)就會(huì)在到達(dá)時(shí)間后把一條WM_TIMER消息投遞到你的窗口消息隊(duì)列里。MFC 把這個(gè)機(jī)制封裝得很簡單調(diào)用SetTimer創(chuàng)建定時(shí)器重寫OnTimer接收消息調(diào)用KillTimer銷毀定時(shí)器。整個(gè)流程對(duì)開發(fā)者來說非常直觀。需要注意的是WM_TIMER消息的優(yōu)先級(jí)比較低只有在消息隊(duì)列中沒有其他更高優(yōu)先級(jí)消息時(shí)才會(huì)被處理。所以定時(shí)器的實(shí)際觸發(fā)間隔會(huì)受到系統(tǒng)繁忙程度的影響不適合用在需要精確計(jì)時(shí)的場(chǎng)合。1.2 列表框ListBox的作用列表框是一個(gè)大家都很熟悉的 Windows 標(biāo)準(zhǔn)控件用于顯示一列文本條目。在 MFC 中它對(duì)應(yīng)CListBox類常用方法包括AddString在末尾添加一個(gè)字符串。InsertString在指定位置插入字符串。DeleteString刪除指定索引的字符串。ResetContent清空所有項(xiàng)。GetCount獲取當(dāng)前條目數(shù)量。當(dāng)我們要?jiǎng)討B(tài)展示不斷產(chǎn)生的數(shù)據(jù)時(shí)列表框是非常直觀的容器。1.3 為什么要把兩者結(jié)合定時(shí)器負(fù)責(zé)“產(chǎn)數(shù)據(jù)”列表框負(fù)責(zé)“展示數(shù)據(jù)”。比如你要做一個(gè)環(huán)境溫度實(shí)時(shí)監(jiān)測(cè)工具定時(shí)器每隔 1 秒讀取一次溫度值然后把溫度字符串添加到列表框中屏幕上就能看到一條條不斷滾動(dòng)的記錄。這種組合方式既避免了手動(dòng)刷新界面的繁瑣操作又不會(huì)因?yàn)楦哳l刷新導(dǎo)致程序卡頓。它會(huì)成為你編寫上位機(jī)、小工具、日志監(jiān)控程序時(shí)的常用套路。2. 環(huán)境準(zhǔn)備與項(xiàng)目說明2.1 開發(fā)環(huán)境本文示例以 Microsoft Visual Studio 為開發(fā)環(huán)境。版本可以是 VS2017、VS2019 或 VS2022操作步驟基本一致。項(xiàng)目類型選擇“MFC 應(yīng)用程序”在向?qū)е羞x擇“基于對(duì)話框”。需要提前安裝的組件是使用 C 的桌面開發(fā)適用于最新 v143 生成工具的 C MFCx86 和 x64如果你在安裝 Visual Studio 時(shí)沒有勾選 MFC 組件可以打開“Visual Studio Installer”選擇“修改”然后勾選對(duì)應(yīng)組件即可。2.2 創(chuàng)建 MFC 對(duì)話框項(xiàng)目打開 Visual Studio按下面步驟創(chuàng)建項(xiàng)目選擇“創(chuàng)建新項(xiàng)目”。搜索“MFC”選擇“MFC 應(yīng)用程序”。項(xiàng)目名稱可以命名為TimerListDemo。點(diǎn)擊“創(chuàng)建”進(jìn)入 MFC 應(yīng)用程序向?qū)?。在“?yīng)用程序類型”中選擇“基于對(duì)話框”。其他選項(xiàng)保持默認(rèn)點(diǎn)擊“完成”。此時(shí)Visual Studio 會(huì)為你生成一個(gè)最基本的對(duì)話框程序。項(xiàng)目中有兩個(gè)核心類CTimerListDemoApp應(yīng)用程序類負(fù)責(zé)程序啟動(dòng)。CTimerListDemoDlg對(duì)話框類負(fù)責(zé)界面邏輯。我們要寫的代碼基本上都在CTimerListDemoDlg這個(gè)類里。2.3 界面布局設(shè)計(jì)打開資源視圖找到對(duì)話框資源IDD_TIMERLISTDEMO_DIALOG。在工具箱中拖入一個(gè)按鈕和一個(gè)列表框。為了演示方便我們?cè)O(shè)計(jì)兩個(gè)按鈕IDC_BTN_START標(biāo)題為“啟動(dòng)定時(shí)器”IDC_BTN_STOP標(biāo)題為“停止定時(shí)器”IDC_LIST_LOG一個(gè) ListBox 控件界面大致如下[ 啟動(dòng)定時(shí)器 ] [ 停止定時(shí)器 ] [ 列表框顯示日志 ]這個(gè)布局最簡單也最容易理解。你還可以在按鈕下面加一個(gè)靜態(tài)文本用來顯示當(dāng)前狀態(tài)不過那不是本次重點(diǎn)。3. MFC 定時(shí)器的工作原理3.1 SetTimer 函數(shù)SetTimer用來創(chuàng)建一個(gè)定時(shí)器它有四種重載形式。我們先看最常用的一種UINT_PTR SetTimer( UINT_PTR nIDEvent, UINT nElapse, void (CALLBACK* lpfnTimer)(HWND, UINT, UINT_PTR, DWORD) nullptr );參數(shù)含義如下nIDEvent定時(shí)器 ID。我們可以在一個(gè)窗口中創(chuàng)建多個(gè)定時(shí)器通過 ID 區(qū)分它們。nElapse觸發(fā)間隔單位是毫秒。比如 1000 表示每隔 1 秒觸發(fā)一次。lpfnTimer回調(diào)函數(shù)指針。通常傳nullptr這樣定時(shí)器消息會(huì)發(fā)送到窗口的OnTimer消息處理函數(shù)中。在 MFC 中我們通常寫SetTimer(1, 1000, nullptr);這條語句的意思是創(chuàng)建一個(gè) ID 為 1 的定時(shí)器每 1000 毫秒觸發(fā)一次。如果返回值非零說明創(chuàng)建成功。3.2 KillTimer 函數(shù)當(dāng)不再需要定時(shí)器時(shí)必須調(diào)用KillTimer來銷毀它避免資源泄漏。KillTimer(1);參數(shù)就是定時(shí)器 ID。銷毀之后窗口中不再收到該 ID 對(duì)應(yīng)的WM_TIMER消息。3.3 WM_TIMER 消息與 ON_WM_TIMER 宏當(dāng)定時(shí)器的時(shí)間到了之后系統(tǒng)會(huì)把WM_TIMER消息發(fā)送到創(chuàng)建定時(shí)器的窗口。在 MFC 中我們需要在消息映射中加入ON_WM_TIMER()宏并在對(duì)話框類中聲明和實(shí)現(xiàn)OnTimer函數(shù)。消息映射部分如下BEGIN_MESSAGE_MAP(CTimerListDemoDlg, CDialogEx) ON_WM_TIMER() ON_BN_CLICKED(IDC_BTN_START, CTimerListDemoDlg::OnBnClickedBtnStart) ON_BN_CLICKED(IDC_BTN_STOP, CTimerListDemoDlg::OnBnClickedBtnStop) END_MESSAGE_MAP()OnTimer函數(shù)的原型是void OnTimer(UINT_PTR nIDEvent);在這個(gè)函數(shù)內(nèi)部我們可以根據(jù)nIDEvent判斷當(dāng)前是哪一號(hào)定時(shí)器觸發(fā)了。4. 完整實(shí)現(xiàn)定時(shí)更新列表框下面進(jìn)入核心部分。我會(huì)按照文件位置一步步寫清楚保證代碼可以直接復(fù)制到你的項(xiàng)目中。4.1 添加控件變量在對(duì)話框頭文件TimerListDemoDlg.h中為列表框添加一個(gè)關(guān)聯(lián)變量。按CtrlShiftX打開類向?qū)г凇俺蓡T變量”選項(xiàng)卡中選擇控件 IDIDC_LIST_LOG點(diǎn)擊“添加變量”。我們將其命名為m_listLog類別選擇Control變量類型選擇CListBox。添加完成后頭文件中會(huì)多出這樣一行// 文件路徑TimerListDemoDlg.h public: CListBox m_listLog;另外我們還需要一個(gè)計(jì)數(shù)器成員變量用來記錄當(dāng)前是第幾次插入數(shù)據(jù)。手動(dòng)在頭文件類定義中添加public: int m_nCount 0;4.2 添加按鈕點(diǎn)擊事件在資源視圖中雙擊“啟動(dòng)定時(shí)器”按鈕VS 會(huì)自動(dòng)生成點(diǎn)擊事件處理函數(shù)。雙擊“停止定時(shí)器”按鈕也會(huì)自動(dòng)生成對(duì)應(yīng)的函數(shù)。生成的函數(shù)位于TimerListDemoDlg.cpp中void CTimerListDemoDlg::OnBnClickedBtnStart() { // TODO: 在此添加控件通知處理程序代碼 } void CTimerListDemoDlg::OnBnClickedBtnStop() { // TODO: 在此添加控件通知處理程序代碼 }我們將在下一步分別實(shí)現(xiàn)“啟動(dòng)”和“停止”邏輯。4.3 在 OnInitDialog 中初始化OnInitDialog是對(duì)話框初始化函數(shù)程序啟動(dòng)時(shí)會(huì)執(zhí)行到這里。我們可以在這里設(shè)置一些初始狀態(tài)比如讓“停止定時(shí)器”按鈕在開始時(shí)不可用。在TimerListDemoDlg.cpp的OnInitDialog中找到return TRUE;之前添加如下代碼BOOL CTimerListDemoDlg::OnInitDialog() { CDialogEx::OnInitDialog(); // 其他初始化代碼... // 初始化界面 GetDlgItem(IDC_BTN_STOP)-EnableWindow(FALSE); m_nCount 0; return TRUE; // 除非將焦點(diǎn)設(shè)置到控件否則返回 TRUE }這里我們用GetDlgItem(IDC_BTN_STOP)-EnableWindow(FALSE);讓“停止”按鈕初始不可用避免程序一啟動(dòng)就誤點(diǎn)擊。4.4 啟動(dòng)定時(shí)器在“啟動(dòng)定時(shí)器”按鈕的點(diǎn)擊事件中調(diào)用SetTimer同時(shí)更新按鈕狀態(tài)。void CTimerListDemoDlg::OnBnClickedBtnStart() { // 創(chuàng)建定時(shí)器ID 為 1間隔 1000 毫秒 BOOL bRet SetTimer(1, 1000, nullptr); if (bRet) { // 啟動(dòng)成功更新按鈕狀態(tài) GetDlgItem(IDC_BTN_START)-EnableWindow(FALSE); GetDlgItem(IDC_BTN_STOP)-EnableWindow(TRUE); } }注意這里我把SetTimer的返回值賦給了BOOL類型變量。在 MFC 中SetTimer返回值為定時(shí)器 ID非零表示成功。用BOOL接收是可行的但更準(zhǔn)確的寫法是UINT_PTR nTimerID SetTimer(1, 1000, nullptr); if (nTimerID ! 0) { // 啟動(dòng)成功 }為了保持代碼直觀下面我們都用布爾判斷方式。4.5 編寫 OnTimer 處理函數(shù)現(xiàn)在是最關(guān)鍵的一步。我們需要在對(duì)話框類中添加OnTimer函數(shù)。如果項(xiàng)目中還沒有ON_WM_TIMER()消息映射你可以在類向?qū)е惺謩?dòng)添加。最簡單的方式是在類視圖中選中CTimerListDemoDlg在屬性窗口頂部點(diǎn)擊“消息”圖標(biāo)找到WM_TIMER添加處理函數(shù)OnTimer。添加后VS 會(huì)自動(dòng)在頭文件和源文件里生成函數(shù)聲明與實(shí)現(xiàn)框架。我們直接在里面填寫邏輯void CTimerListDemoDlg::OnTimer(UINT_PTR nIDEvent) { if (nIDEvent 1) { // 每觸發(fā)一次計(jì)數(shù)器加 1 m_nCount; // 生成一條包含計(jì)數(shù)值的字符串 CString strText; strText.Format(_T(記錄 %d第 %d 次刷新), m_nCount, m_nCount); // 添加到列表框 m_listLog.AddString(strText); // 如果條目過多自動(dòng)刪除最舊的一條保持列表只顯示最近 100 條 if (m_listLog.GetCount() 100) { m_listLog.DeleteString(0); } } CDialogEx::OnTimer(nIDEvent); }這段代碼的含義很容易理解每次定時(shí)器觸發(fā)時(shí)計(jì)數(shù)器加 1。用Format生成格式化字符串。通過AddString把它加到列表框末尾。當(dāng)總數(shù)超過 100 條時(shí)刪除第 0 條最上面的最舊的記錄保證界面不無限增長。4.6 停止定時(shí)器在“停止定時(shí)器”按鈕的點(diǎn)擊事件中調(diào)用KillTimer同時(shí)恢復(fù)按鈕狀態(tài)。void CTimerListDemoDlg::OnBnClickedBtnStop() { // 銷毀定時(shí)器 KillTimer(1); // 更新按鈕狀態(tài) GetDlgItem(IDC_BTN_START)-EnableWindow(TRUE); GetDlgItem(IDC_BTN_STOP)-EnableWindow(FALSE); }這樣用戶就可以隨時(shí)啟動(dòng)和停止定時(shí)器。4.7 在窗口關(guān)閉時(shí)銷毀定時(shí)器我們還需要注意一個(gè)問題如果用戶沒有點(diǎn)擊“停止”按鈕直接關(guān)閉了對(duì)話框窗口那么定時(shí)器仍然存在嗎答案是當(dāng)窗口銷毀時(shí)Windows 會(huì)默認(rèn)銷毀該窗口創(chuàng)建的定時(shí)器所以一般不會(huì)造成嚴(yán)重泄漏。但為了代碼嚴(yán)謹(jǐn)我們可以在OnDestroy消息處理函數(shù)中主動(dòng)銷毀定時(shí)器。打開類向?qū)г趯?duì)話框類中添加WM_DESTROY消息處理函數(shù)OnDestroy然后實(shí)現(xiàn)void CTimerListDemoDlg::OnDestroy() { // 銷毀定時(shí)器 KillTimer(1); CDialogEx::OnDestroy(); }這樣做的好處是即使按鈕狀態(tài)沒有正確保存窗口關(guān)閉時(shí)也會(huì)把定時(shí)器資源清理干凈。4.8 運(yùn)行效果編譯并運(yùn)行程序。點(diǎn)擊“啟動(dòng)定時(shí)器”按鈕后你會(huì)看到列表框里每秒增加一條記錄內(nèi)容類似記錄 1第 1 次刷新 記錄 2第 2 次刷新 記錄 3第 3 次刷新 ...點(diǎn)擊“停止定時(shí)器”列表停止增長。再次點(diǎn)擊“啟動(dòng)定時(shí)器”記錄會(huì)繼續(xù)從上次的計(jì)數(shù)往下增長。這個(gè)小程序就完整跑通了“定時(shí)器 列表框”的聯(lián)動(dòng)邏輯。5. 擴(kuò)展功能多定時(shí)器與數(shù)據(jù)處理實(shí)際項(xiàng)目中一個(gè)窗口往往不止有一個(gè)定時(shí)器。比如一邊定時(shí)刷新傳感器數(shù)據(jù)一邊定時(shí)檢查網(wǎng)絡(luò)連接狀態(tài)。這時(shí)就需要通過不同的 ID 來區(qū)分。5.1 使用多個(gè)定時(shí)器你可以像下面這樣創(chuàng)建兩個(gè)定時(shí)器SetTimer(1, 1000, nullptr); // 秒級(jí)刷新 SetTimer(2, 5000, nullptr); // 5 秒級(jí)刷新然后在OnTimer中分別處理void CTimerListDemoDlg::OnTimer(UINT_PTR nIDEvent) { switch (nIDEvent) { case 1: m_listLog.AddString(_T(1 秒定時(shí)器觸發(fā))); break; case 2: m_listLog.AddString(_T(5 秒定時(shí)器觸發(fā))); break; default: break; } CDialogEx::OnTimer(nIDEvent); }這樣設(shè)計(jì)條理清晰擴(kuò)展起來也很方便。5.2 在列表框中顯示時(shí)間戳如果我們需要在每條記錄前加上當(dāng)前時(shí)間可以使用CTime類void CTimerListDemoDlg::OnTimer(UINT_PTR nIDEvent) { if (nIDEvent 1) { CTime now CTime::GetCurrentTime(); CString strTime now.Format(_T(%H:%M:%S)); m_nCount; CString strText; strText.Format(_T([%s] 第 %d 條刷新數(shù)據(jù)), strTime, m_nCount); m_listLog.AddString(strText); if (m_listLog.GetCount() 100) { m_listLog.DeleteString(0); } } CDialogEx::OnTimer(nIDEvent); }這樣列表里每條記錄都帶上了時(shí)間看起來更像一個(gè)完整的日志系統(tǒng)。5.3 限制列表框容量上面的代碼已經(jīng)展示了限制最大行數(shù)的方式。這里再強(qiáng)調(diào)一下如果功能是持續(xù)采集數(shù)據(jù)不能無限制地向列表框中添加內(nèi)容。每添加一條記錄內(nèi)存占用就會(huì)增加一點(diǎn)。雖然單條字符串很小但長時(shí)間運(yùn)行后數(shù)量會(huì)非常龐大導(dǎo)致程序內(nèi)存暴漲、界面變卡。所以最佳做法是每次添加后判斷總數(shù)超過閾值就刪除最舊的一條索引 0。也可以用下面這種寫法保證列表始終顯示最新的 100 條while (m_listLog.GetCount() 100) { m_listLog.DeleteString(0); } m_listLog.AddString(strText);兩種方式都可以第一種更節(jié)省性能因?yàn)橹辉诔迺r(shí)刪除一次。6. 常見問題與排查思路在實(shí)際開發(fā)中你可能遇到各種奇怪的現(xiàn)象。下面整理了一些高頻問題并給出排查方向。問題現(xiàn)象常見原因解決思路定時(shí)器不觸發(fā)忘記添加ON_WM_TIMER()消息映射檢查消息映射中是否有ON_WM_TIMER()并確認(rèn)OnTimer函數(shù)簽名正確定時(shí)器不觸發(fā)SetTimer調(diào)用失敗檢查返回值確認(rèn)窗口句柄有效確認(rèn)沒有重復(fù)創(chuàng)建相同 ID 導(dǎo)致沖突界面卡死在OnTimer中執(zhí)行了耗時(shí)操作不要在定時(shí)器處理函數(shù)中做耗時(shí)計(jì)算可以放到工作線程中列表框內(nèi)容無限增長沒有限制條目數(shù)量添加后判斷GetCount()超過閾值刪除舊記錄關(guān)閉窗口后程序仍在運(yùn)行OnDestroy中沒有銷毀定時(shí)器重寫WM_DESTROY消息處理調(diào)用KillTimer多個(gè)定時(shí)器互相干擾沒有用nIDEvent區(qū)分為每個(gè)定時(shí)器分配不同的 ID在OnTimer中用switch或if分支處理定時(shí)器間隔不準(zhǔn)系統(tǒng)繁忙或定時(shí)器精度限制使用更低優(yōu)先級(jí)的方式運(yùn)行其它任務(wù)或使用WaitableTimer等高精度定時(shí)器程序剛啟動(dòng)時(shí)列表為空還沒有觸發(fā)定時(shí)器檢查初始化時(shí)是否調(diào)用了SetTimer或者間隔設(shè)置是否過大7. 最佳實(shí)踐與工程建議7.1 定時(shí)器處理函數(shù)不要做耗時(shí)操作OnTimer運(yùn)行在 UI 線程中。如果你在里面寫了大循環(huán)、文件讀寫、網(wǎng)絡(luò)請(qǐng)求界面就無法及時(shí)處理鼠標(biāo)、鍵盤和重繪消息表現(xiàn)出來就是窗口卡死。正確的做法是在OnTimer中只做輕量操作比如從共享變量中讀取數(shù)據(jù)、更新控件。真正的耗時(shí)任務(wù)放到工作線程中完成線程計(jì)算完后再通過自定義消息或PostMessage通知 UI 線程更新。7.2 建議使用成員變量保存定時(shí)器 ID有些例子直接用數(shù)字1來創(chuàng)建和銷毀定時(shí)器這樣寫確實(shí)簡單但工程維護(hù)時(shí)不太友好。更推薦的做法是定義常量或枚舉// 在頭文件中定義 #define TIMER_ID_REFRESH 1 #define TIMER_ID_CHECK 2或者使用enumenum { TIMER_ID_REFRESH 1, TIMER_ID_CHECK 2 };這樣在代碼中看到SetTimer(TIMER_ID_REFRESH, 1000, nullptr)一眼就能明白這個(gè)定時(shí)器的用途也方便后續(xù)添加新定時(shí)器。7.3 使用類向?qū)ЬS護(hù)消息處理函數(shù)雖然可以手動(dòng)在頭文件和源文件中添加OnTimer聲明與實(shí)現(xiàn)但使用向?qū)Ц踩?。向?qū)?huì)自動(dòng)生成正確的消息映射和函數(shù)簽名減少低級(jí)錯(cuò)誤。尤其是初學(xué)者建議在類向?qū)е刑砑覹M_TIMER和WM_DESTROY的處理函數(shù)而不是手動(dòng)復(fù)制網(wǎng)上代碼。這樣可以避免因?yàn)轭^文件格式不一致而導(dǎo)致的編譯錯(cuò)誤。7.4 定時(shí)器間隔不是越小越好有人為了讓界面看起來更“實(shí)時(shí)”把定時(shí)器間隔設(shè)置為 1 毫秒。這在 Windows 消息定時(shí)器上并沒有意義因?yàn)閃M_TIMER消息并不會(huì)保證 1 毫秒觸發(fā)一次而且頻繁觸發(fā)會(huì)讓 UI 線程忙于處理定時(shí)器消息浪費(fèi) CPU。對(duì)于常規(guī)界面刷新100 毫秒到 1000 毫秒是常見的選擇。如果需求是精確測(cè)量時(shí)間或者高頻采樣建議使用多媒體定時(shí)器或高精度事件定時(shí)器。7.5 注意定時(shí)器 ID 沖突同一個(gè)窗口內(nèi)定時(shí)器 ID 必須唯一。如果你在多個(gè)地方都使用SetTimer(1, ...)后者會(huì)覆蓋前者導(dǎo)致前一個(gè)定時(shí)器失效。所以在多模塊協(xié)作時(shí)盡量使用較大的數(shù)字或者枚舉值或者由公共模塊統(tǒng)一分配。7.6 列表框更新后的滾動(dòng)定位當(dāng)列表框條目很多時(shí)AddString會(huì)在最后添加一行但滾動(dòng)條不一定自動(dòng)滾到底部。如果你希望用戶永遠(yuǎn)看到最新一條需要在添加后設(shè)置當(dāng)前選中項(xiàng)并確保它可見int nIndex m_listLog.AddString(strText); m_listLog.SetCurSel(nIndex);如果你使用的是CListBox的默認(rèn)風(fēng)格SetCurSel會(huì)讓選中項(xiàng)高亮同時(shí)自動(dòng)滾動(dòng)到可見區(qū)域。如果你不想顯示選中狀態(tài)可以改用SetTopIndex來調(diào)整滾動(dòng)位置但通常日志場(chǎng)景里允許高亮。8. 最后的經(jīng)驗(yàn)小結(jié)到這里“定時(shí)器 列表框”的完整鏈路已經(jīng)打通了。這個(gè)功能雖然看起來簡單但它背后包含了 Windows 消息機(jī)制、控件操作、資源管理和 UI 線程安全等一系列基礎(chǔ)知識(shí)。以后你再遇到“每隔一段時(shí)間刷新界面”“動(dòng)態(tài)往列表里加數(shù)據(jù)”的需求都可以直接套用這套思路SetTimer創(chuàng)建定時(shí)器OnTimer處理邏輯AddString更新列表框KillTimer釋放資源。把這個(gè)套路練熟后面再學(xué)習(xí)工作線程、自定義消息、數(shù)據(jù)庫輪詢等功能時(shí)會(huì)順利很多。希望這篇文章能幫你解決實(shí)際問題。如果你在運(yùn)行過程中遇到了其他報(bào)錯(cuò)歡迎對(duì)照上面的排查表一步步檢查。動(dòng)手練習(xí)一遍比你只看不做要有效得多。