Windows API 程序

一、实现目标

本次练习使用 C++ 和 Windows API 编写一个简单的桌面窗口程序，了解 Windows 图形界面程序的基本结构，以及窗口创建、消息处理、文字绘制和音频播放的实现方法。

程序主要实现以下功能：

1. 创建标题为“我的第一个Win窗口”的窗口。
2. 显示灰色客户区，并在中央显示一行文字。
3. 鼠标移动到客户区时显示手型光标。
4. 标题栏不显示最小化、最大化和关闭按钮。
5. 使用 MCI 播放外部 WAV 音频文件。
6. 按下 Esc 键关闭窗口，并释放音频资源。

二、项目文件与运行准备

本例使用 Visual Studio 的 C++ Windows 桌面项目，音频文件名为hellowin.wav。

示例运行目录如下：

D:\Users\1\source\repos\Project1\x64\Debug\ ├── Project1.exe ├── Project1.pdb └── hellowin.wav

其中，Project1.exe是可执行程序，Project1.pdb是调试符号文件，hellowin.wav是程序播放的音频文件。

【此处插入文件目录截图，即提供的图二】

本文代码使用音频文件的绝对路径。运行前需要把代码中的路径改成自己电脑上音频文件的实际位置。仅把 WAV 文件放到 EXE 旁边，并不会自动改变代码指定的路径。

三、完整代码

下面的代码在原始实现上修正了路径转义和窗口样式注释，移除了本例不需要的音频通知设置，并增加了窗口创建、音频播放和消息读取的错误判断。

#include <windows.h> #include <mmsystem.h> // 链接 Windows 多媒体库 #pragma comment(lib, "winmm.lib") // 窗口过程函数声明 LRESULT CALLBACK WndProc( HWND hWnd, UINT msg, WPARAM wParam, LPARAM lParam ); // 显示 MCI 错误信息 void ShowAudioError(HWND hWnd, MCIERROR error, LPCWSTR title) { WCHAR errorText[256] = {}; if (!mciGetErrorStringW(error, errorText, 256)) { lstrcpyW(errorText, L"无法获取音频错误信息。"); } MessageBoxW(hWnd, errorText, title, MB_OK | MB_ICONERROR); } // Windows 程序入口 int WINAPI WinMain( HINSTANCE hInstance, HINSTANCE, LPSTR, int nCmdShow ) { const WCHAR className[] = L"MyWinClass"; WNDCLASSEXW wndClass = {}; wndClass.cbSize = sizeof(wndClass); wndClass.style = CS_HREDRAW | CS_VREDRAW; wndClass.lpfnWndProc = WndProc; wndClass.hInstance = hInstance; wndClass.hIcon = LoadIconW(NULL, IDI_APPLICATION); wndClass.hCursor = LoadCursorW(NULL, IDC_HAND); // 使用系统“灰色文字”颜色作为窗口背景 wndClass.hbrBackground = GetSysColorBrush(COLOR_GRAYTEXT); wndClass.lpszClassName = className; wndClass.hIconSm = LoadIconW(NULL, IDI_APPLICATION); // 1. 注册窗口类 if (!RegisterClassExW(&wndClass)) { MessageBoxW( NULL, L"窗口类注册失败！", L"错误", MB_OK | MB_ICONERROR ); return 1; } // 2. 创建窗口 // WS_CAPTION：带标题栏。 // 不添加系统菜单、最小化框和最大化框。 HWND hWnd = CreateWindowExW( 0, className, L"我的第一个Win窗口", WS_CAPTION, CW_USEDEFAULT, CW_USEDEFAULT, 650, 320, NULL, NULL, hInstance, NULL ); if (hWnd == NULL) { MessageBoxW( NULL, L"窗口创建失败！", L"错误", MB_OK | MB_ICONERROR ); return 1; } // 3. 显示并更新窗口 ShowWindow(hWnd, nCmdShow); UpdateWindow(hWnd); // 4. 打开音频文件 // 请修改为自己的实际路径。 // C++ 字符串中的反斜杠需要写成 \\。 // 文件路径使用双引号包围，以支持包含空格的路径。 MCIERROR result = mciSendStringW( L"open \"D:\\Users\\1\\source\\repos\\Project1" L"\\x64\\Debug\\hellowin.wav\" type waveaudio alias music", NULL, 0, NULL ); bool musicOpened = (result == 0); if (!musicOpened) { ShowAudioError(hWnd, result, L"音频打开失败"); } else { // 播放一次，不使用 wait，窗口仍可响应消息 result = mciSendStringW( L"play music", NULL, 0, NULL ); if (result != 0) { ShowAudioError(hWnd, result, L"音频播放失败"); } } // 5. 消息循环 MSG msg = {}; BOOL messageResult; while ((messageResult = GetMessageW( &msg, NULL, 0, 0 )) > 0) { TranslateMessage(&msg); DispatchMessageW(&msg); } // 6. 释放音频资源 if (musicOpened) { mciSendStringW(L"close music", NULL, 0, NULL); } if (messageResult == -1) { MessageBoxW( NULL, L"读取窗口消息失败！", L"错误", MB_OK | MB_ICONERROR ); return 1; } return static_cast<int>(msg.wParam); } // 窗口过程：处理绘制、键盘和销毁等消息 LRESULT CALLBACK WndProc( HWND hWnd, UINT msg, WPARAM wParam, LPARAM lParam ) { switch (msg) { case WM_PAINT: { PAINTSTRUCT ps = {}; HDC hdc = BeginPaint(hWnd, &ps); RECT rect = {}; GetClientRect(hWnd, &rect); const WCHAR text[] = L"大家好，这是我的第一个Windows API程序!"; // 保留运行截图中的黑字白底效果 SetTextColor(hdc, RGB(0, 0, 0)); SetBkColor(hdc, RGB(255, 255, 255)); SetBkMode(hdc, OPAQUE); DrawTextW( hdc, text, -1, &rect, DT_SINGLELINE | DT_CENTER | DT_VCENTER ); EndPaint(hWnd, &ps); return 0; } case WM_KEYDOWN: if (wParam == VK_ESCAPE) { DestroyWindow(hWnd); return 0; } break; case WM_DESTROY: PostQuitMessage(0); return 0; } // 未处理的消息交给系统默认窗口过程 return DefWindowProcW(hWnd, msg, wParam, lParam); }

代码采用带W后缀的 Unicode 接口和L"..."宽字符串，便于统一处理中文文本。

四、程序的基本执行流程

Windows 窗口程序由消息驱动。窗口创建后，程序持续接收系统和用户操作产生的消息，再交给窗口过程处理。

本例的执行流程为：

WinMain 入口 ↓ 填充并注册窗口类 ↓ 创建窗口 ↓ 显示窗口 ↓ 打开并播放音频 ↓ 进入消息循环 ↓ WndProc 处理绘图和键盘消息 ↓ 按下 Esc，销毁窗口 ↓ 退出消息循环，关闭音频资源

WNDCLASSEXW用来描述窗口类的属性，包括窗口过程、鼠标光标、背景画刷和图标等。调用RegisterClassExW注册后，便可以使用CreateWindowExW创建该类的窗口。

需要区分窗口类名称与窗口标题：MyWinClass用于标识窗口类，而“我的第一个Win窗口”才是显示在标题栏中的文字。

五、关键功能解析

1. 创建只有标题栏的窗口

本例的窗口样式使用：

WS_CAPTION

需要纠正一个容易混淆的地方：WS_CAPTION并不等于WS_BORDER，它包含WS_BORDER和WS_DLGFRAME。本例没有添加WS_SYSMENU、WS_MINIMIZEBOX和WS_MAXIMIZEBOX，因此不显示通常位于右上角的三个窗口按钮。微软窗口样式文档

由于没有关闭按钮，程序通过 Esc 键提供退出方式。

2. 设置背景与手型光标

窗口背景使用：

wndClass.hbrBackground = GetSysColorBrush(COLOR_GRAYTEXT);

COLOR_GRAYTEXT表示系统用于灰显文字的颜色。本例将它作为客户区背景，因此截图中呈现灰色。它属于系统颜色，实际显示可能随系统主题变化。

鼠标光标通过以下代码设置：

wndClass.hCursor = LoadCursorW(NULL, IDC_HAND);

当鼠标位于窗口客户区时，默认窗口处理会使用该手型光标。

3. 在客户区中央显示文字

文字绘制放在WM_PAINT消息处理中：

DrawTextW( hdc, text, -1, &rect, DT_SINGLELINE | DT_CENTER | DT_VCENTER );

三个标志分别表示单行显示、水平居中和垂直居中。GetClientRect获取客户区范围，因此文字相对于内容区域居中，不包含标题栏。

绘制操作由BeginPaint开始、EndPaint结束。将绘图放在WM_PAINT中，可以让窗口需要重绘时重新显示文字。

4. 为什么文字后面有白色底块？

运行截图中的文字带有白色背景。本例使用不透明文字背景模式，并明确将文字背景色设为白色，以保留这一效果。

如果希望文字直接显示在灰色客户区上，可以将：

SetBkMode(hdc, OPAQUE);

替换为：

SetBkMode(hdc, TRANSPARENT);

透明模式不会填充文字背景，底下的灰色客户区便会保留下来。微软 SetBkMode 文档

5. 打开与播放 WAV 音频

音频操作通过mciSendStringW发送字符串命令完成：

// 播放已经以 music 为别名打开的音频 mciSendStringW(L"play music", NULL, 0, NULL); // 关闭音频 mciSendStringW(L"close music", NULL, 0, NULL);

music是打开音频时指定的别名，后续播放和关闭操作通过它引用音频设备。

本文只实现播放一次，没有实现循环播放，也没有使用播放完成通知，因此整理后的代码省去了原始代码中的set music notify on。

打开和播放音频分别检查返回值。如果失败，就使用mciGetErrorStringW获取错误说明，帮助定位路径或音频文件问题。

6. 消息循环与退出处理

消息循环主要完成三个步骤：

GetMessageW(...); // 获取消息 TranslateMessage(...); // 将相应按键消息转换为字符消息 DispatchMessageW(...); // 分发给窗口过程

GetMessageW获取普通消息时返回正值，遇到WM_QUIT返回0，失败时返回-1。因此，代码使用> 0作为循环条件，并在循环结束后单独判断错误。微软 GetMessage 文档

当窗口获得键盘焦点并按下 Esc 时，退出过程为：

WM_KEYDOWN ↓ DestroyWindow ↓ WM_DESTROY ↓ PostQuitMessage ↓ GetMessage 返回 0 ↓ 关闭音频并退出程序