我们的第一个 Win32 API 程序：从黑框到窗口的第一次跨越

一、实验目标

这次实验要完成的任务并不复杂，但每一步都触及 Windows 编程的核心概念：

1. 创建一个背景为灰色的窗口，正中央显示一行文字："大家好，这是我的第一个Windows API程序！"
2. 程序后台循环播放 hellowin.wav 背景音乐；
3. 通过代码把窗口样式改成只保留标题栏；
4. 把鼠标指针设置为手型。

实验环境：Windows 10/11 + Visual Studio (C++)，依赖 Win32 API 和 winmm.lib。

二、核心思路：Windows 程序是"事件驱动"的

在写第一行代码之前，最大的观念转变是：Windows 程序不是从上到下顺序执行的，而是围绕消息（Message）运转的。

整个程序的生命周期可以概括为：

WinMain
 ├─ 1. 注册窗口类 (RegisterClass)
 ├─ 2. 创建窗口 (CreateWindow)
 ├─ 3. 显示窗口 (ShowWindow / UpdateWindow)
 ├─ 4. 消息循环 (GetMessage → TranslateMessage → DispatchMessage)
 └─ 窗口过程 WndProc：用 switch-case 响应 WM_PAINT、WM_DESTROY 等消息

程序启动后，WinMain 里的消息循环不断接收系统和用户触发的事件，真正的业务逻辑则封装在窗口过程函数 WndProc 中。WinMain 负责"活下来"，WndProc 负责"有反应"——这是我们理解这个框架的关键。

三、关键代码解析与实际效果

1. 注册窗口类：定制窗口的"出厂设置"

WNDCLASS wndclass;
wndclass.style         = CS_HREDRAW | CS_VREDRAW;          // 尺寸变化时重绘
wndclass.lpfnWndProc   = WndProc;                          // 绑定窗口过程
wndclass.hCursor       = LoadCursor(NULL, IDC_HAND);       // 修改1：手型指针
wndclass.hbrBackground = (HBRUSH)GetStockObject(GRAY_BRUSH); // 修改2：灰色背景
wndclass.lpszClassName = szAppName;

if (!RegisterClass(&wndclass)) { /* 错误处理 */ }

hCursor 和 hbrBackground 这两个字段让我们意识到：一个窗口的很多"外观属性"，其实在创建之前就已经通过窗口类声明好了。为了保证手型指针在任何情况下都生效，我们还在 WndProc 里补了一个 WM_SETCURSOR 消息处理，主动调用 SetCursor。

2. 动态修改窗口样式：位运算的实战

窗口创建后，要求"只保留标题栏"。Windows 的窗口样式是由一系列 WS_ 常量按位组合而成的，于是可以用位运算精确剔除不需要的部分：

LONG style = GetWindowLong(hwnd, GWL_STYLE);
// 剔除最大化、最小化按钮和可调边框
style = style & ~(WS_MAXIMIZEBOX | WS_MINIMIZEBOX | WS_THICKFRAME);
SetWindowLong(hwnd, GWL_STYLE, style);
// 关键一步：强制系统重新计算非客户区
SetWindowPos(hwnd, NULL, 0, 0, 0, 0,
    SWP_NOMOVE | SWP_NOSIZE | SWP_NOZORDER | SWP_FRAMECHANGED);

这里有个容易被忽略的细节：改完样式必须调用 SetWindowPos 并带上 SWP_FRAMECHANGED 标志，否则系统不会重新绘制窗口边框，改动看起来"没生效"。这体现了 Windows 图形界面系统严谨的刷新机制。

3. GDI 绘图：让文字精准居中

绘制文字发生在 WM_PAINT 消息里，使用 GDI（图形设备接口）：

case WM_PAINT:
    hdc = BeginPaint(hwnd, &ps);
    GetClientRect(hwnd, &rect);            // 获取客户区大小
    SetTextColor(hdc, RGB(0, 0, 0));
    SetBkMode(hdc, TRANSPARENT);           // 背景透明，不遮挡灰色底色
    DrawText(hdc, szText, -1, &rect,
             DT_CENTER | DT_VCENTER | DT_SINGLELINE); // 水平+垂直居中
    EndPaint(hwnd, &ps);
    return 0;

三个要点：

• BeginPaint / EndPaint 必须成对出现，它们围绕的是设备上下文（DC）这个概念；
• SetBkMode(hdc, TRANSPARENT) 很重要，否则文字背后会有一块默认底色，破坏灰色背景；
• DT_CENTER | DT_VCENTER 这两个标志组合，配合单行标志 DT_SINGLELINE，一行代码实现精准居中。

4. 循环播放背景音乐

多媒体部分出乎意料地简单，一行搞定：

#pragma comment(lib, "winmm.lib")  // 链接多媒体库
PlaySound(_T("hellowin.wav"), NULL, SND_FILENAME | SND_ASYNC | SND_LOOP);

三个标志的组合含义：从文件播放、异步播放（不阻塞消息循环）、循环播放。程序退出前记得 PlaySound(NULL, NULL, 0) 停止播放即可。

5. 运行效果

四、踩过的两个坑

坑 1：无法解析的外部符号 main

编译直接报错。原因很典型：建项目时选的是"控制台应用程序"，链接器默认寻找 main 入口，而我们的代码入口是 WinMain。

解决方案（二选一）：

• 项目属性 → 链接器 → 系统 → 子系统，从 控制台 (/SUBSYSTEM:CONSOLE) 改为 窗口 (/SUBSYSTEM:WINDOWS)；
• 或者把入口改成 main——但不建议，会带出一个难看的黑框。

坑 2：音频文件无法播放

两个原因叠加：

1. 忘记添加 #pragma comment(lib, "winmm.lib")，导致链接错误；
2. 音频用了绝对路径，换台机器就失效。最终把 hellowin.wav 放到与 .vcxproj 同级的目录（即 exe 的工作目录），改用相对路径 _T("hellowin.wav")，问题解决。

五、收获与体会

1. 真正理解了消息驱动机制。GetMessage → TranslateMessage → DispatchMessage 构成的消息循环，配合 WndProc 里的 switch-case，就是 Windows 程序的标准范式。以前背书式的"事件驱动"四个字，这次总算落了地。

2. 掌握了 GDI 绘图和窗口属性的动态定制。从设备上下文到 DrawText 的居中标志，再到用位运算增删 WS_ 样式，窗口的"长相"和"内容"都可以在运行时精确控制——前提是理解系统的刷新规则（比如 SWP_FRAMECHANGED）。

3. 熟悉了多媒体接口和项目配置。PlaySound 异步循环播放很简单，但背后 winmm.lib 的链接方式、资源文件的相对路径依赖、以及控制台/窗口子系统的区别，都是只有亲手踩坑才能记住的知识。

第一次写窗口程序，代码不过百行，但从"程序为什么不停下来"到"窗口为什么没变化"，每一个疑问的答案都指向 Windows 更底层的运行机制。这只是开始，接下来打算继续探索消息自定义、双缓冲绘图这些话题。

---