批量重命名是个很典型的小工具:左边一个输入框填规则,中间一个按钮执行,下面一块区域列出改前改后的名字。功能不复杂,但真写起来,新手会连续卡在三件事上——按钮点了没反应、控件挤在一起或者被窗口边缘切掉、窗口一拉大所有东西都待在原地。
这三件事分别对应 Win32 的三个基础:事件怎么传、坐标怎么算、重绘什么时候发生。这篇用标准控件把这套流程走一遍。代码不长,但足够你把「控件」这个概念从「界面上的元素」拉回到它的本质:一个带父子关系的子窗口。
控件不是画上去的,是创建出来的
Win32 没有「控件对象」这种独立物种。按钮、输入框、静态文字,都是窗口,只不过风格里带了 WS_CHILD,父窗口是你的主窗口。系统内置了这些窗口类,类名就是字符串:BUTTON、EDIT、STATIC、LISTBOX、COMBOBOX。用 CreateWindowExW 创建它们,和创建主窗口是同一个 API。
既然是子窗口,它就有句柄、有位置、有大小、有窗口过程。区别在于:子窗口的窗口过程由系统实现,你不直接处理它的 WndProc;它把用户操作包装成通知,发给父窗口。按钮被点击时,父窗口收到 WM_COMMAND,里面带着「哪个控件、发生了什么」。
ES_AUTOHSCROLL、BS_PUSHBUTTON。WM_COMMAND / WM_NOTIFY,根据控件 ID 分发到对应的处理逻辑。控件 ID 是个整数,创建时通过 CreateWindowExW 的 HMENU 参数传进去。同一个父窗口下 ID 要唯一,因为父窗口就是靠它来分辨「是哪个控件发来的消息」。很多人用 1001、1002 这种手写常量,规模一大就容易撞号;更稳妥的做法是定义成 constexpr int 并集中管理。
既然是子窗口,对控件的操作也可以直接用消息完成:SetWindowTextW 内部就是发 WM_SETTEXT,GetWindowTextW 是 WM_GETTEXT;按钮的 BM_CLICK、列表框的 LB_ADDSTRING 也都是这一类。理解这一点,看文档时就不会被「函数」和「消息」两套写法绕晕——大多数控件 API 只是对消息的薄封装,消息能做的事,函数只是换了个更好记的名字。
事件怎么走:WM_COMMAND 与通知码
点击按钮,父窗口的窗口过程会收到 WM_COMMAND。这条消息的三个参数各有含义:LOWORD(wParam) 是控件 ID,HIWORD(wParam) 是通知码,lParam 是控件句柄。按钮的通知码是 BN_CLICKED,输入框内容变化是 EN_CHANGE,下拉框选择变化是 CBN_SELCHANGE。
所以「按钮点了没反应」的第一排查点不是按钮,而是父窗口有没有处理 WM_COMMAND,以及 ID 对不对。很多人把按钮创建在 main 里,父窗口却设成了 nullptr,结果按钮成了独立的顶层窗口,点击自然不会通知到主窗口。还有人 ID 传了 0,父窗口收到消息时无从判断来源。
标准控件用 WM_COMMAND,更复杂的通用控件(列表视图、树视图、日期选择器)用 WM_NOTIFY,参数是一个 NMHDR 结构,里面同样有控件 ID 和通知码。两者的分发思路一样,只是 WM_NOTIFY 携带的信息更多。
EN_CHANGE 在你调用 SetWindowTextW 时也会触发。写「实时预览」逻辑时要注意这一点,否则程序自己改值会引发一轮自己触发的更新,严重时递归。按钮的样式也影响行为。普通按钮是 BS_PUSHBUTTON,按回车不会自动触发;对话框里的默认按钮要用 BS_DEFPUSHBUTTON,系统才会在用户按回车时代它响应。复选框和单选按钮同样是 BUTTON 类,只是样式不同,通知码也从 BN_CLICKED 变成了「选中状态变化」。如果把这些都当成独立控件类型去找 API,会越找越乱——记住它们都是同一个窗口类,只是样式位不一样。
还有一类通知容易被漏:编辑框按回车在对话框里会变成 IDOK,在普通窗口里则什么都不发生;要自己截 WM_KEYDOWN 判断 VK_RETURN。这种「同一控件在不同容器里行为不同」的差异,文档里往往写得分散,遇到时先确认窗口是不是对话框。
布局:坐标是自己算的
Win32 没有 CSS,也没有 Qt 的布局管理器。控件创建时给一个矩形,之后窗口大小变了,要不要移动、要不要拉伸,全看你在 WM_SIZE 里怎么写。小工具常见的做法是把客户区分成几行,每行按比例或固定高度分配:
这套算法听起来土,但对只有五六个控件的工具完全够用。真正麻烦的是两件事:一是控件多了以后,重复的坐标计算会写成一大坨;二是高 DPI 屏幕上,你按 96 DPI 写死的 20 像素边距,在 150% 缩放下会显得很挤。
窗口本身也要设最小尺寸。用户把窗口拖得很窄时,手算布局会算出负的控件宽度,MoveWindow 收到负数后控件直接消失。办法是处理 WM_GETMINMAXINFO,把 ptMinTrackSize 设成一个不会让控件重叠的值。这个细节平时看不出来,直到有人把窗口拖到屏幕边缘。
DPI 的处理分两步。第一步是在创建任何窗口之前声明感知级别,让系统不要替你做位图拉伸:
SetProcessDpiAwarenessContext(DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2);
第二步是把尺寸按当前 DPI 缩放。可以用 GetDpiForWindow(hwnd) 拿到窗口所在显示器的 DPI,再按 dpi / 96.0 的比例换算边距和字号。窗口在显示器之间移动时会收到 WM_DPICHANGED,里面带着建议的新矩形,照着它调整窗口和控件即可。
多显示器下还要注意:WM_DPICHANGED 之后必须重排一次。系统只给你建议的窗口矩形,不会替你移动子控件;如果坐标是按旧 DPI 算的,窗口挪到另一块屏幕后控件就会错位。处理方式是把布局代码抽成一个函数,WM_SIZE 和 WM_DPICHANGED 都调它。
如果这两步都不做,程序在 150% 缩放下会被系统整体拉伸,文字发虚、线条变粗;只做第一步不做第二步,界面会变得很小。两种坏结果都很常见,而且开发机是 100% 缩放时完全看不出来。
字体高度也要算。控件高度小于实际行高时,文字会被切掉一半,而 CreateFontW 的第一个参数是「字符高度」而不是排版软件里的字号。稳妥做法是用 GetDC 加 GetTextExtentPoint32W 量一次目标字体在目标 DPI 下的行高,再给控件留出上下内边距;不要凭经验写死 24 或 28 像素。系统缩放是 100% 时这两个值看起来都够用,换到 150% 就露馅。
一次完整的实测走查
下面这个程序创建了静态文字、输入框和按钮,统一设置中文字体,点击按钮后把输入内容写到标签上。为了在无人值守的环境里也能验证,它用定时器在 1.2 秒后自动触发一次按钮点击,再延迟关闭。代码完整可编译:
#define UNICODE
#define _UNICODE
#include <windows.h>
#include <cstdio>
constexpr int kIdEdit = 100;
constexpr int kIdButton = 101;
HWND g_label = nullptr;
HWND g_edit = nullptr;
HWND g_button = nullptr;
HFONT g_font = nullptr;
LRESULT CALLBACK WndProc(HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam) {
switch (msg) {
case WM_CREATE: {
g_label = CreateWindowExW(
0, L"STATIC", L"准备就绪", WS_CHILD | WS_VISIBLE,
20, 18, 300, 24, hwnd, nullptr, nullptr, nullptr);
g_edit = CreateWindowExW(
WS_EX_CLIENTEDGE, L"EDIT", L"", WS_CHILD | WS_VISIBLE | ES_AUTOHSCROLL,
20, 48, 300, 28, hwnd, reinterpret_cast<HMENU>(kIdEdit), nullptr, nullptr);
g_button = CreateWindowExW(
0, L"BUTTON", L"转换", WS_CHILD | WS_VISIBLE | BS_PUSHBUTTON,
20, 86, 100, 32, hwnd, reinterpret_cast<HMENU>(kIdButton), nullptr, nullptr);
g_font = CreateFontW(
16, 0, 0, 0, FW_NORMAL, FALSE, FALSE, FALSE, DEFAULT_CHARSET,
OUT_DEFAULT_PRECIS, CLIP_DEFAULT_PRECIS, CLEARTYPE_QUALITY,
DEFAULT_PITCH | FF_DONTCARE, L"Microsoft YaHei UI");
SendMessageW(g_label, WM_SETFONT, reinterpret_cast<WPARAM>(g_font), TRUE);
SendMessageW(g_edit, WM_SETFONT, reinterpret_cast<WPARAM>(g_font), TRUE);
SendMessageW(g_button, WM_SETFONT, reinterpret_cast<WPARAM>(g_font), TRUE);
return 0;
}
case WM_COMMAND: {
int id = LOWORD(wParam);
int code = HIWORD(wParam);
if (id == kIdButton && code == BN_CLICKED) {
wchar_t buf[128]{};
GetWindowTextW(g_edit, buf, 128);
std::printf("[click] input=%ls\n", buf);
SetWindowTextW(g_label, buf[0] ? buf : L"输入为空");
wchar_t label[128]{};
GetWindowTextW(g_label, label, 128);
std::printf("[click] label=%ls\n", label);
}
return 0;
}
case WM_TIMER:
if (wParam == 1) {
SendMessageW(g_button, BM_CLICK, 0, 0);
SetTimer(hwnd, 2, 800, nullptr);
} else if (wParam == 2) {
DestroyWindow(hwnd);
}
return 0;
case WM_DESTROY:
if (g_font) DeleteObject(g_font);
PostQuitMessage(0);
return 0;
default:
return DefWindowProcW(hwnd, msg, wParam, lParam);
}
}
int main() {
WNDCLASSW wc{};
wc.lpfnWndProc = WndProc;
wc.hInstance = GetModuleHandleW(nullptr);
wc.lpszClassName = L"ControlsDemo";
wc.hCursor = LoadCursorW(nullptr, IDC_ARROW);
RegisterClassW(&wc);
HWND hwnd = CreateWindowExW(
0, L"ControlsDemo", L"controls demo", WS_OVERLAPPEDWINDOW,
200, 200, 380, 200, nullptr, nullptr, wc.hInstance, nullptr);
ShowWindow(hwnd, SW_SHOW);
UpdateWindow(hwnd);
SetWindowTextW(g_edit, L" report 2024 (draft).txt ");
SetTimer(hwnd, 1, 1200, nullptr);
MSG msg{};
while (GetMessageW(&msg, nullptr, 0, 0) > 0) {
TranslateMessage(&msg);
DispatchMessageW(&msg);
}
return 0;
}
编译运行:
g++ -std=c++20 controls.cpp -o controls.exe -lgdi32 -luser32
.\controls.exe
本机实际输出:
[click] input= report 2024 (draft).txt
[click] label= report 2024 (draft).txt
注意输出里首尾的空格被原样保留了。这不是 bug,而是输入框的本职工作:它不改用户输入。真实的批量重命名工具要在读取之后自己做 trim、非法字符替换、重名检查,这些属于业务逻辑,不该让控件承担。
把这段逻辑展开,一次批量重命名至少要做四步检查:trim 去掉首尾空白;把反斜杠、斜杠、冒号、星号、问号、引号、尖括号、竖线这些 Windows 文件名不允许的字符替换掉;检查目标名是否和同目录已有文件重名;检查新名字长度是否超过文件系统限制。四步都应该在点「执行」之后、真正调用 MoveFileW 之前完成,失败时把原因写回界面,而不是弹一个「操作失败」了事。控件只负责把用户敲的字原样交出来,规则放在自己的函数里,才能被单元测试覆盖。
代码里还有两个细节值得记:
控件创建放在 WM_CREATE 里,而不是 main 里。因为主窗口的客户区尺寸在 CreateWindowExW 返回后才是最终值,而且窗口重建、主题切换时可能需要重新创建控件,放在窗口过程里更好维护。代价是子控件的句柄要存在全局或窗口关联的结构里,这里的示例用了全局变量,工程里一般挂在窗口的用户数据上。
字体只创建一次,通过 WM_SETFONT 分发给三个控件,销毁窗口时 DeleteObject。字体、画刷、位图这类 GDI 对象是系统资源,创建了就要释放;但也不能在控件还活着的时候删,否则控件下次绘制会用到已释放的句柄。
还有一个时序细节:WM_CREATE 到达时窗口句柄已经有效,但客户区尺寸还没最终确定,所以不要在这里按固定尺寸算布局。要拿真实客户区,等 WM_SIZE 第一次到达,或者显式调 GetClientRect。示例把控件创建放在 WM_CREATE、把重排留给 WM_SIZE,就是按这个顺序来的。
SendMessage(BM_CLICK) 驱动业务逻辑——它会让「用户操作」和「程序调用」混在一起。正确做法是把点击处理抽成一个普通函数,按钮消息和定时器都调它。拉伸窗口时控件不跟着动
上面的示例窗口可以拉伸,但控件不会动。这不是遗漏,而是没写 WM_SIZE 的结果。补上之后大致是这样:
case WM_SIZE: {
int w = LOWORD(lParam);
int h = HIWORD(lParam);
if (g_edit) {
MoveWindow(g_edit, 20, 48, w - 40, 28, TRUE);
MoveWindow(g_button, 20, 86, 100, 32, TRUE);
}
return 0;
}
MoveWindow 的最后一个参数为 TRUE 时会触发重绘,窗口拉伸时性能一般,但小工具无所谓。控件多时可以改成 SetWindowPos 配合 BeginDeferWindowPos 批量移动,减少中间重绘。
还有一个问题:按钮、输入框在窗口里靠 WS_TABSTOP 支持 Tab 切换,但只在对话框里由系统自动处理。普通窗口要自己处理 WM_KEYDOWN 或调用 IsDialogMessage,否则用户按 Tab 不会跳到下一个控件。键盘可访问性在内部工具里经常被忽略,但用键盘操作的人会立刻发现。
如果工具要列出文件,最省事的是 LISTBOX:用 LB_ADDSTRING 加行、LB_GETCURSEL 取选中项、LB_RESETCONTENT 清空。但它只能显示单列纯文本,做「改前 / 改后」两列对齐就力不从心,这时该换 ListView(WC_LISTVIEW),通过 LVM_INSERTITEM 插入带多列的结构化数据。控件选型的原则很简单:先用系统自带的最简单控件,撑不住了再换,不要为了将来可能有的需求一上来就上重型控件。
行数上千时还有一层:ListView 用 LVS_OWNERDATA 走虚拟列表,只问你要当前可见的几行,不为每行建结构。批量重命名工具通常几十到几百个文件,用不上;但同一个模式放大到日志查看器就必须考虑,否则插入几千行时界面会明显卡顿。
出问题时先看哪里
| 现象 | 真实原因 | 第一步查什么 |
|---|---|---|
| 控件完全不显示 | 创建失败,或没加 WS_VISIBLE | 检查 CreateWindowExW 的返回值是否为 nullptr,再看样式里有没有 WS_VISIBLE |
| 按钮点了没反应 | 父窗口没处理 WM_COMMAND,或控件 ID 不匹配 | 在 WM_COMMAND 里打印 LOWORD(wParam) 和 HIWORD(wParam),对照创建时的 ID |
| 输入框不能输入 | 控件创建时父窗口传错,或样式缺少 WS_TABSTOP / 被禁用 | 确认创建时的父窗口是主窗口,且没有调用 EnableWindow(hwnd, FALSE) |
| 控件位置正确但文字被切掉 | 控件高度小于字体的实际行高,或 DPI 缩放后尺寸没跟着变 | 用 GetTextExtentPoint32W 或 GetDC 量一下字高,再核对 DPI 换算 |
| 窗口拉大后控件堆在左上角 | 没有处理 WM_SIZE,控件仍用创建时的坐标 | 在 WM_SIZE 里断点,确认 MoveWindow 是否被调用 |
| 高分屏上界面发虚 | 进程是 DPI 不感知的,系统把整个窗口位图放大 | 检查是否在创建窗口前调用了 SetProcessDpiAwarenessContext |
| 程序退出时偶发崩溃 | GDI 对象在控件销毁前被删除,或重复删除 | 确认 DeleteObject 的时机在子控件销毁之后,且每个对象只删一次 |
| 中文显示成方块 | 字体不含中文字形,或控件用了 ANSI 版 API | 把字体显式设成「Microsoft YaHei UI」或「宋体」,并确认统一用 ...W 接口 |
边界与代价
标准控件的好处是「系统原生」:外观跟系统一致,输入法、复制粘贴、无障碍、高对比度主题都自动支持。坏处也是「系统原生」:它们停留在很老的视觉风格,圆角、阴影、动画都没有;想做得现代,要么自绘(BS_OWNERDRAW),要么换框架。
手算布局在控件少于十个时很快,超过十个就开始难受:每加一个控件,要改所有相关的坐标计算;窗口缩放、DPI 变化、字体变化都要重新算。Qt 的布局管理器就是为这件事生的,它把「谁在谁上面、谁占多少空间」交给约束求解,而不是人手写像素。
事件分发也是同理。裸 Win32 的 WM_COMMAND 是一个大 switch,控件一多就变成「ID 路由表」。这不是不能维护,而是扩展性差:加一个控件要改三处(创建、ID 常量、消息处理)。Qt 的信号槽把「谁发出、谁接收」直接写在连接处,增删控件的影响面小得多。
同一台机器上,用 CMake 4.4.4、MSVC 19.51(工具集 14.51.36231)和 Qt 6.8.3 起的 qtlab 工程可以拿来对照。构造完打印的是 [window] QMainWindow 已构造,size = QSize(640, 480);界面里没有一行坐标,控件交给布局管理器,窗口拉大时布局自己重算,不需要写 WM_SIZE。
事件连接的结果是可检查的。把按钮的 clicked 连到 onAddClicked,日志是 [connect] clicked -> onAddClicked 返回值 true;故意把信号名拼错,同一处日志变成返回值 false。这个布尔值就是 QObject::connect 的返回值,名字对、签名兼容才为真。裸 Win32 的 WM_COMMAND 没有「连接失败」这个概念——ID 写错消息照发,只是没人处理,界面表现为点了没反应,你只能靠打印 LOWORD(wParam) 去猜。
列表那边走模型视图。改一行数据后日志是 [model] dataChanged 发射,行 0 状态改为 false,视图收到信号自己刷新,不用手动 InvalidateRect 或 SetWindowTextW。LISTBOX 没有这层抽象,改数据、刷新、取选中项都得自己发消息,控件一多就是一堆 LB_* 常量的堆叠。
所以这条路的适用边界很清楚:界面简单、控件固定、只跑 Windows、追求体积和零依赖,就用标准控件;界面会持续迭代、要跨平台、要自定义视觉,就早点上 Qt,别在坐标计算里耗时间。
小结
控件是子窗口,点击是父窗口收到的 WM_COMMAND,位置是创建时给的矩形,窗口变化要靠 WM_SIZE 自己重排。把这三句话记住,大部分「控件不显示」「点了没反应」「拉大窗口就乱」的问题都能定位。
当天可以自己验证的练习:
- 把按钮的 ID 改成和输入框相同,观察点击时会发生什么,理解 ID 唯一性的必要。
- 在
WM_COMMAND里加一条EN_CHANGE分支,打印输入框每次变化的内容。 - 删除
WM_SIZE处理(如果已加),拉伸窗口对比控件行为;再加上后对比一次。 - 把
CreateFontW的字号从 16 改成 28,观察哪些控件文字被切掉,思考高度该怎么算。 - 用系统「设置」把显示缩放改成 150%,运行程序,观察有没有发虚或错位,再补 DPI 声明。
下一篇讲资源、图标与本地文件。界面能用了,下一步就是让它像一个正式软件:有自己的图标、版本信息,能把配置存到正确的位置,而不是在客户机上到处找不到文件。