Windows API 程序

一、实现目标本次练习使用 C 和 Windows API 编写一个简单的桌面窗口程序了解 Windows 图形界面程序的基本结构以及窗口创建、消息处理、文字绘制和音频播放的实现方法。程序主要实现以下功能创建标题为“我的第一个Win窗口”的窗口。显示灰色客户区并在中央显示一行文字。鼠标移动到客户区时显示手型光标。标题栏不显示最小化、最大化和关闭按钮。使用 MCI 播放外部 WAV 音频文件。按下 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[] LMyWinClass; 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( Lopen \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( Lplay 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(Lclose music, NULL, 0, NULL); } if (messageResult -1) { MessageBoxW( NULL, L读取窗口消息失败, L错误, MB_OK | MB_ICONERROR ); return 1; } return static_castint(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(Lplay music, NULL, 0, NULL); // 关闭音频 mciSendStringW(Lclose 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 ↓ 关闭音频并退出程序