批量重命名是个很典型的小工具:左边一个输入框填规则,中间一个按钮执行,下面一块区域列出改前改后的名字。功能不复杂,但真写起来,新手会连续卡在三件事上——按钮点了没反应、控件挤在一起或者被窗口边缘切掉、窗口一拉大所有东西都待在原地。

这三件事分别对应 Win32 的三个基础:事件怎么传、坐标怎么算、重绘什么时候发生。这篇用标准控件把这套流程走一遍。代码不长,但足够你把「控件」这个概念从「界面上的元素」拉回到它的本质:一个带父子关系的子窗口。

控件不是画上去的,是创建出来的

Win32 没有「控件对象」这种独立物种。按钮、输入框、静态文字,都是窗口,只不过风格里带了 WS_CHILD,父窗口是你的主窗口。系统内置了这些窗口类,类名就是字符串:BUTTON、EDIT、STATIC、LISTBOX、COMBOBOX。用 CreateWindowExW 创建它们,和创建主窗口是同一个 API。

既然是子窗口,它就有句柄、有位置、有大小、有窗口过程。区别在于:子窗口的窗口过程由系统实现,你不直接处理它的 WndProc;它把用户操作包装成通知,发给父窗口。按钮被点击时,父窗口收到 WM_COMMAND,里面带着「哪个控件、发生了什么」。

主窗口拥有客户区,负责整体布局、菜单、关闭流程。控件的位置都相对于它的客户区左上角。
控件(子窗口)有自己的 HWND 和控件 ID。样式决定外观和行为,比如 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 里怎么写。小工具常见的做法是把客户区分成几行,每行按比例或固定高度分配:

一个够用的手算布局
取客户区GetClientRect 拿到可用宽高
留边距上下左右各留 16 像素
分行标签、输入框、按钮、列表依次排
设位置MoveWindow 或 SetWindowPos

这套算法听起来土,但对只有五六个控件的工具完全够用。真正麻烦的是两件事:一是控件多了以后,重复的坐标计算会写成一大坨;二是高 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 自己重排。把这三句话记住,大部分「控件不显示」「点了没反应」「拉大窗口就乱」的问题都能定位。

当天可以自己验证的练习:

  1. 把按钮的 ID 改成和输入框相同,观察点击时会发生什么,理解 ID 唯一性的必要。
  2. 在 WM_COMMAND 里加一条 EN_CHANGE 分支,打印输入框每次变化的内容。
  3. 删除 WM_SIZE 处理(如果已加),拉伸窗口对比控件行为;再加上后对比一次。
  4. 把 CreateFontW 的字号从 16 改成 28,观察哪些控件文字被切掉,思考高度该怎么算。
  5. 用系统「设置」把显示缩放改成 150%,运行程序,观察有没有发虚或错位,再补 DPI 声明。

下一篇讲资源、图标与本地文件。界面能用了,下一步就是让它像一个正式软件:有自己的图标、版本信息,能把配置存到正确的位置,而不是在客户机上到处找不到文件。