在开发 Windows 桌面应用时，经常需要让界面“自己动起来”——比如每隔一秒刷新一次状态、持续采集设备数据并显示在列表里、或者在日志列表里自动追加新记录。很多新手最容易想到的做法是写一个while(1)循环不断更新控件，结果窗口直接卡死，鼠标转圈。其实，在 MFC 里有一个非常轻量的解决思路，就是用定时器配合列表框完成间歇性刷新。
这篇文章就是围绕“添加定时器，更新列表框内容”这个实战场景展开的。我会从概念讲起，再逐步带你完成一个可运行的 MFC 示例程序。内容包括：定时器如何创建和销毁、WM_TIMER消息怎么处理、CListBox控件如何添加和删除数据、以及实际开发中最容易踩到的坑。适合刚开始接触 MFC 的读者，也适合需要快速实现定时刷新功能的开发者。
1. 定时器与列表框的基础概念
1.1 定时器是什么
在 Windows 编程里，定时器不是硬件定时器，也不是高精度计时器，而是一个基于消息机制的软件定时工具。你告诉系统“每 1000 毫秒通知我一次”，系统就会在到达时间后，把一条WM_TIMER消息投递到你的窗口消息队列里。
MFC 把这个机制封装得很简单：调用SetTimer创建定时器，重写OnTimer接收消息，调用KillTimer销毁定时器。整个流程对开发者来说非常直观。
需要注意的是，WM_TIMER消息的优先级比较低，只有在消息队列中没有其他更高优先级消息时才会被处理。所以，定时器的实际触发间隔会受到系统繁忙程度的影响，不适合用在需要精确计时的场合。
1.2 列表框（ListBox）的作用
列表框是一个大家都很熟悉的 Windows 标准控件，用于显示一列文本条目。在 MFC 中，它对应CListBox类，常用方法包括：
AddString：在末尾添加一个字符串。InsertString：在指定位置插入字符串。DeleteString：删除指定索引的字符串。ResetContent：清空所有项。GetCount：获取当前条目数量。
当我们要动态展示不断产生的数据时，列表框是非常直观的容器。
1.3 为什么要把两者结合
定时器负责“产数据”，列表框负责“展示数据”。比如你要做一个环境温度实时监测工具，定时器每隔 1 秒读取一次温度值，然后把温度字符串添加到列表框中，屏幕上就能看到一条条不断滚动的记录。
这种组合方式，既避免了手动刷新界面的繁琐操作，又不会因为高频刷新导致程序卡顿。它会成为你编写上位机、小工具、日志监控程序时的常用套路。
2. 环境准备与项目说明
2.1 开发环境
本文示例以 Microsoft Visual Studio 为开发环境。版本可以是 VS2017、VS2019 或 VS2022，操作步骤基本一致。项目类型选择“MFC 应用程序”，在向导中选择“基于对话框”。
需要提前安装的组件是：
- 使用 C++ 的桌面开发
- 适用于最新 v143 生成工具的 C++ MFC（x86 和 x64）
如果你在安装 Visual Studio 时没有勾选 MFC 组件，可以打开“Visual Studio Installer”，选择“修改”，然后勾选对应组件即可。
2.2 创建 MFC 对话框项目
打开 Visual Studio，按下面步骤创建项目：
- 选择“创建新项目”。
- 搜索“MFC”，选择“MFC 应用程序”。
- 项目名称可以命名为
TimerListDemo。 - 点击“创建”，进入 MFC 应用程序向导。
- 在“应用程序类型”中选择“基于对话框”。
- 其他选项保持默认，点击“完成”。
此时，Visual Studio 会为你生成一个最基本的对话框程序。项目中有两个核心类：
CTimerListDemoApp：应用程序类，负责程序启动。CTimerListDemoDlg：对话框类，负责界面逻辑。
我们要写的代码基本上都在CTimerListDemoDlg这个类里。
2.3 界面布局设计
打开资源视图，找到对话框资源IDD_TIMERLISTDEMO_DIALOG。在工具箱中拖入一个按钮和一个列表框。
为了演示方便，我们设计两个按钮：
IDC_BTN_START，标题为“启动定时器”IDC_BTN_STOP，标题为“停止定时器”IDC_LIST_LOG，一个 ListBox 控件
界面大致如下：
[ 启动定时器 ] [ 停止定时器 ] [ 列表框（显示日志） ]这个布局最简单，也最容易理解。你还可以在按钮下面加一个静态文本，用来显示当前状态，不过那不是本次重点。
3. MFC 定时器的工作原理
3.1 SetTimer 函数
SetTimer用来创建一个定时器，它有四种重载形式。我们先看最常用的一种：
UINT_PTR SetTimer( UINT_PTR nIDEvent, UINT nElapse, void (CALLBACK* lpfnTimer)(HWND, UINT, UINT_PTR, DWORD) = nullptr );参数含义如下：
nIDEvent：定时器 ID。我们可以在一个窗口中创建多个定时器，通过 ID 区分它们。nElapse：触发间隔，单位是毫秒。比如 1000 表示每隔 1 秒触发一次。lpfnTimer：回调函数指针。通常传nullptr，这样定时器消息会发送到窗口的OnTimer消息处理函数中。
在 MFC 中，我们通常写：
SetTimer(1, 1000, nullptr);这条语句的意思是：创建一个 ID 为 1 的定时器，每 1000 毫秒触发一次。如果返回值非零，说明创建成功。
3.2 KillTimer 函数
当不再需要定时器时，必须调用KillTimer来销毁它，避免资源泄漏。
KillTimer(1);参数就是定时器 ID。销毁之后，窗口中不再收到该 ID 对应的WM_TIMER消息。
3.3 WM_TIMER 消息与 ON_WM_TIMER 宏
当定时器的时间到了之后，系统会把WM_TIMER消息发送到创建定时器的窗口。在 MFC 中，我们需要在消息映射中加入ON_WM_TIMER()宏，并在对话框类中声明和实现OnTimer函数。
消息映射部分如下：
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函数的原型是：
void OnTimer(UINT_PTR nIDEvent);在这个函数内部，我们可以根据nIDEvent判断当前是哪一号定时器触发了。
4. 完整实现：定时更新列表框
下面进入核心部分。我会按照文件位置一步步写清楚，保证代码可以直接复制到你的项目中。
4.1 添加控件变量
在对话框头文件TimerListDemoDlg.h中，为列表框添加一个关联变量。按Ctrl+Shift+X打开类向导，在“成员变量”选项卡中选择控件 IDIDC_LIST_LOG，点击“添加变量”。
我们将其命名为m_listLog，类别选择Control，变量类型选择CListBox。
添加完成后，头文件中会多出这样一行：
// 文件路径：TimerListDemoDlg.h public: CListBox m_listLog;另外，我们还需要一个计数器成员变量，用来记录当前是第几次插入数据。手动在头文件类定义中添加：
public: int m_nCount = 0;4.2 添加按钮点击事件
在资源视图中双击“启动定时器”按钮，VS 会自动生成点击事件处理函数。双击“停止定时器”按钮，也会自动生成对应的函数。
生成的函数位于TimerListDemoDlg.cpp中：
void CTimerListDemoDlg::OnBnClickedBtnStart() { // TODO: 在此添加控件通知处理程序代码 } void CTimerListDemoDlg::OnBnClickedBtnStop() { // TODO: 在此添加控件通知处理程序代码 }我们将在下一步分别实现“启动”和“停止”逻辑。
4.3 在 OnInitDialog 中初始化
OnInitDialog是对话框初始化函数，程序启动时会执行到这里。我们可以在这里设置一些初始状态，比如让“停止定时器”按钮在开始时不可用。
在TimerListDemoDlg.cpp的OnInitDialog中找到return TRUE;之前，添加如下代码：
BOOL CTimerListDemoDlg::OnInitDialog() { CDialogEx::OnInitDialog(); // 其他初始化代码... // 初始化界面 GetDlgItem(IDC_BTN_STOP)->EnableWindow(FALSE); m_nCount = 0; return TRUE; // 除非将焦点设置到控件，否则返回 TRUE }这里我们用GetDlgItem(IDC_BTN_STOP)->EnableWindow(FALSE);让“停止”按钮初始不可用，避免程序一启动就误点击。
4.4 启动定时器
在“启动定时器”按钮的点击事件中，调用SetTimer，同时更新按钮状态。
void CTimerListDemoDlg::OnBnClickedBtnStart() { // 创建定时器，ID 为 1，间隔 1000 毫秒 BOOL bRet = SetTimer(1, 1000, nullptr); if (bRet) { // 启动成功，更新按钮状态 GetDlgItem(IDC_BTN_START)->EnableWindow(FALSE); GetDlgItem(IDC_BTN_STOP)->EnableWindow(TRUE); } }注意，这里我把SetTimer的返回值赋给了BOOL类型变量。在 MFC 中，SetTimer返回值为定时器 ID，非零表示成功。用BOOL接收是可行的，但更准确的写法是：
UINT_PTR nTimerID = SetTimer(1, 1000, nullptr); if (nTimerID != 0) { // 启动成功 }为了保持代码直观，下面我们都用布尔判断方式。
4.5 编写 OnTimer 处理函数
现在是最关键的一步。我们需要在对话框类中添加OnTimer函数。
如果项目中还没有ON_WM_TIMER()消息映射，你可以在类向导中手动添加。最简单的方式是：在类视图中选中CTimerListDemoDlg，在属性窗口顶部点击“消息”图标，找到WM_TIMER，添加处理函数OnTimer。
添加后，VS 会自动在头文件和源文件里生成函数声明与实现框架。我们直接在里面填写逻辑：
void CTimerListDemoDlg::OnTimer(UINT_PTR nIDEvent) { if (nIDEvent == 1) { // 每触发一次，计数器加 1 m_nCount++; // 生成一条包含计数值的字符串 CString strText; strText.Format(_T("记录 %d：第 %d 次刷新"), m_nCount, m_nCount); // 添加到列表框 m_listLog.AddString(strText); // 如果条目过多，自动删除最旧的一条，保持列表只显示最近 100 条 if (m_listLog.GetCount() > 100) { m_listLog.DeleteString(0); } } CDialogEx::OnTimer(nIDEvent); }这段代码的含义很容易理解：
- 每次定时器触发时，计数器加 1。
- 用
Format生成格式化字符串。 - 通过
AddString把它加到列表框末尾。 - 当总数超过 100 条时，删除第 0 条（最上面的最旧的记录），保证界面不无限增长。
4.6 停止定时器
在“停止定时器”按钮的点击事件中调用KillTimer，同时恢复按钮状态。
void CTimerListDemoDlg::OnBnClickedBtnStop() { // 销毁定时器 KillTimer(1); // 更新按钮状态 GetDlgItem(IDC_BTN_START)->EnableWindow(TRUE); GetDlgItem(IDC_BTN_STOP)->EnableWindow(FALSE); }这样用户就可以随时启动和停止定时器。
4.7 在窗口关闭时销毁定时器
我们还需要注意一个问题：如果用户没有点击“停止”按钮，直接关闭了对话框窗口，那么定时器仍然存在吗？
答案是：当窗口销毁时，Windows 会默认销毁该窗口创建的定时器，所以一般不会造成严重泄漏。但为了代码严谨，我们可以在OnDestroy消息处理函数中主动销毁定时器。
打开类向导，在对话框类中添加WM_DESTROY消息处理函数OnDestroy，然后实现：
void CTimerListDemoDlg::OnDestroy() { // 销毁定时器 KillTimer(1); CDialogEx::OnDestroy(); }这样做的好处是，即使按钮状态没有正确保存，窗口关闭时也会把定时器资源清理干净。
4.8 运行效果
编译并运行程序。点击“启动定时器”按钮后，你会看到列表框里每秒增加一条记录，内容类似：
记录 1：第 1 次刷新 记录 2：第 2 次刷新 记录 3：第 3 次刷新 ...点击“停止定时器”，列表停止增长。再次点击“启动定时器”，记录会继续从上次的计数往下增长。
这个小程序就完整跑通了“定时器 + 列表框”的联动逻辑。
5. 扩展功能：多定时器与数据处理
实际项目中，一个窗口往往不止有一个定时器。比如一边定时刷新传感器数据，一边定时检查网络连接状态。这时就需要通过不同的 ID 来区分。
5.1 使用多个定时器
你可以像下面这样创建两个定时器：
SetTimer(1, 1000, nullptr); // 秒级刷新 SetTimer(2, 5000, nullptr); // 5 秒级刷新然后在OnTimer中分别处理：
void CTimerListDemoDlg::OnTimer(UINT_PTR nIDEvent) { switch (nIDEvent) { case 1: m_listLog.AddString(_T("1 秒定时器触发")); break; case 2: m_listLog.AddString(_T("5 秒定时器触发")); break; default: break; } CDialogEx::OnTimer(nIDEvent); }这样设计条理清晰，扩展起来也很方便。
5.2 在列表框中显示时间戳
如果我们需要在每条记录前加上当前时间，可以使用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 条刷新数据"), strTime, m_nCount); m_listLog.AddString(strText); if (m_listLog.GetCount() > 100) { m_listLog.DeleteString(0); } } CDialogEx::OnTimer(nIDEvent); }这样列表里每条记录都带上了时间，看起来更像一个完整的日志系统。
5.3 限制列表框容量
上面的代码已经展示了限制最大行数的方式。这里再强调一下：如果功能是持续采集数据，不能无限制地向列表框中添加内容。每添加一条记录，内存占用就会增加一点。虽然单条字符串很小，但长时间运行后，数量会非常庞大，导致程序内存暴涨、界面变卡。
所以最佳做法是，每次添加后判断总数，超过阈值就删除最旧的一条（索引 0）。
也可以用下面这种写法，保证列表始终显示最新的 100 条：
while (m_listLog.GetCount() >= 100) { m_listLog.DeleteString(0); } m_listLog.AddString(strText);两种方式都可以，第一种更节省性能，因为只在超限时删除一次。
6. 常见问题与排查思路
在实际开发中，你可能遇到各种奇怪的现象。下面整理了一些高频问题，并给出排查方向。
| 问题现象 | 常见原因 | 解决思路 |
|---|---|---|
| 定时器不触发 | 忘记添加ON_WM_TIMER()消息映射 | 检查消息映射中是否有ON_WM_TIMER()，并确认OnTimer函数签名正确 |
| 定时器不触发 | SetTimer调用失败 | 检查返回值，确认窗口句柄有效，确认没有重复创建相同 ID 导致冲突 |
| 界面卡死 | 在OnTimer中执行了耗时操作 | 不要在定时器处理函数中做耗时计算，可以放到工作线程中 |
| 列表框内容无限增长 | 没有限制条目数量 | 添加后判断GetCount()，超过阈值删除旧记录 |
| 关闭窗口后程序仍在运行 | OnDestroy中没有销毁定时器 | 重写WM_DESTROY消息处理，调用KillTimer |
| 多个定时器互相干扰 | 没有用nIDEvent区分 | 为每个定时器分配不同的 ID，在OnTimer中用switch或if分支处理 |
| 定时器间隔不准 | 系统繁忙或定时器精度限制 | 使用更低优先级的方式运行其它任务，或使用WaitableTimer等高精度定时器 |
| 程序刚启动时列表为空 | 还没有触发定时器 | 检查初始化时是否调用了SetTimer，或者间隔设置是否过大 |
7. 最佳实践与工程建议
7.1 定时器处理函数不要做耗时操作
OnTimer运行在 UI 线程中。如果你在里面写了大循环、文件读写、网络请求，界面就无法及时处理鼠标、键盘和重绘消息，表现出来就是窗口卡死。
正确的做法是：在OnTimer中只做轻量操作，比如从共享变量中读取数据、更新控件。真正的耗时任务放到工作线程中完成，线程计算完后再通过自定义消息或PostMessage通知 UI 线程更新。
7.2 建议使用成员变量保存定时器 ID
有些例子直接用数字1来创建和销毁定时器，这样写确实简单，但工程维护时不太友好。更推荐的做法是定义常量或枚举：
// 在头文件中定义 #define TIMER_ID_REFRESH 1 #define TIMER_ID_CHECK 2或者使用enum：
enum { TIMER_ID_REFRESH = 1, TIMER_ID_CHECK = 2 };这样在代码中看到SetTimer(TIMER_ID_REFRESH, 1000, nullptr)，一眼就能明白这个定时器的用途，也方便后续添加新定时器。
7.3 使用类向导维护消息处理函数
虽然可以手动在头文件和源文件中添加OnTimer声明与实现，但使用向导更安全。向导会自动生成正确的消息映射和函数签名，减少低级错误。
尤其是初学者，建议在类向导中添加WM_TIMER和WM_DESTROY的处理函数，而不是手动复制网上代码。这样可以避免因为头文件格式不一致而导致的编译错误。
7.4 定时器间隔不是越小越好
有人为了让界面看起来更“实时”，把定时器间隔设置为 1 毫秒。这在 Windows 消息定时器上并没有意义，因为WM_TIMER消息并不会保证 1 毫秒触发一次，而且频繁触发会让 UI 线程忙于处理定时器消息，浪费 CPU。
对于常规界面刷新，100 毫秒到 1000 毫秒是常见的选择。如果需求是精确测量时间或者高频采样，建议使用多媒体定时器或高精度事件定时器。
7.5 注意定时器 ID 冲突
同一个窗口内，定时器 ID 必须唯一。如果你在多个地方都使用SetTimer(1, ...)，后者会覆盖前者，导致前一个定时器失效。所以，在多模块协作时，尽量使用较大的数字或者枚举值，或者由公共模块统一分配。
7.6 列表框更新后的滚动定位
当列表框条目很多时，AddString会在最后添加一行，但滚动条不一定自动滚到底部。如果你希望用户永远看到最新一条，需要在添加后设置当前选中项，并确保它可见：
int nIndex = m_listLog.AddString(strText); m_listLog.SetCurSel(nIndex);如果你使用的是CListBox的默认风格，SetCurSel会让选中项高亮，同时自动滚动到可见区域。如果你不想显示选中状态，可以改用SetTopIndex来调整滚动位置，但通常日志场景里允许高亮。
8. 最后的经验小结
到这里，“定时器 + 列表框”的完整链路已经打通了。这个功能虽然看起来简单，但它背后包含了 Windows 消息机制、控件操作、资源管理和 UI 线程安全等一系列基础知识。
以后你再遇到“每隔一段时间刷新界面”“动态往列表里加数据”的需求，都可以直接套用这套思路：SetTimer创建定时器，OnTimer处理逻辑，AddString更新列表框，KillTimer释放资源。把这个套路练熟，后面再学习工作线程、自定义消息、数据库轮询等功能时，会顺利很多。
希望这篇文章能帮你解决实际问题。如果你在运行过程中遇到了其他报错，欢迎对照上面的排查表一步步检查。动手练习一遍，比你只看不做要有效得多。
