Win32窗口程序开发入门：从零创建C语言窗口应用

1. 项目概述

第一次在Windows平台上创建原生窗口程序，对很多开发者来说就像学习骑自行车——看似简单，但真正上手时才发现需要掌握不少细节。作为Windows开发最基础也最重要的技能之一，Win32窗口程序构成了几乎所有Windows应用程序的基石。

这个项目将带你从零开始，用C语言手写一个完整的Win32窗口程序。不同于现代框架的封装，我们将直接调用Windows API，理解窗口创建的核心机制。你会学到如何注册窗口类、创建主窗口、处理消息循环，以及响应基本的用户交互。

2. 开发环境准备

2.1 工具选择

对于Win32开发，最轻量级的工具组合就是文本编辑器加命令行编译器。我推荐使用VS Code作为编辑器，配合Microsoft的C/C++扩展。编译器方面，MinGW或Visual Studio自带的cl.exe都是不错的选择。

如果你已经安装了Visual Studio，可以直接使用它提供的完整开发环境。但为了更深入理解构建过程，我们先从命令行开始：

bash复制# 检查编译器是否就绪
cl /?

2.2 项目结构

创建一个干净的目录作为项目根目录，建议包含以下文件：

code复制/win32-first-window
  ├── main.c    # 主程序文件
  ├── Makefile  # 构建脚本(可选)
  └── build.bat # Windows构建批处理

3. Win32程序基础架构

3.1 程序入口点

与C语言控制台程序的main函数不同，Win32图形程序的入口是WinMain函数。这个差异源于Windows程序需要处理图形界面和消息机制：

c复制int WINAPI WinMain(
    HINSTANCE hInstance,      // 当前实例句柄
    HINSTANCE hPrevInstance,  // 旧版Windows使用，现在总是NULL
    LPSTR     lpCmdLine,      // 命令行参数
    int       nCmdShow        // 窗口显示方式
)

注意：WINAPI是__stdcall调用约定的宏定义，这是Windows API的标准调用方式。

3.2 窗口类注册

在创建窗口前，必须先注册一个窗口类(WNDCLASS)。这相当于告诉系统你的窗口有哪些特性：

c复制WNDCLASS wc = {0};
wc.lpfnWndProc   = WindowProc;  // 窗口过程函数
wc.hInstance     = hInstance;   // 程序实例句柄
wc.lpszClassName = "MyWindowClass"; // 窗口类名

RegisterClass(&wc);

关键参数解析：

• lpfnWndProc: 处理所有窗口消息的回调函数
• hIcon: 窗口图标，可加载资源图标
• hCursor: 鼠标指针样式
• hbrBackground: 窗口背景色，如(COLOR_WINDOW+1)

3.3 创建主窗口

注册完窗口类后，就可以创建窗口实例了：

c复制HWND hwnd = CreateWindow(
    "MyWindowClass",         // 注册的类名
    "我的第一个Win32窗口",   // 窗口标题
    WS_OVERLAPPEDWINDOW,     // 窗口样式
    
    // 位置和大小
    CW_USEDEFAULT, CW_USEDEFAULT, 
    800, 600,
    
    NULL,       // 父窗口
    NULL,       // 菜单
    hInstance,  
    NULL        // 附加数据
);

窗口样式常用选项：

• WS_OVERLAPPEDWINDOW: 标准可调整窗口
• WS_POPUP: 无边框窗口
• WS_CHILD: 子窗口

4. 消息循环实现

4.1 消息泵机制

Windows程序的核心是消息循环，它不断从消息队列中取出并分发消息：

c复制MSG msg;
while (GetMessage(&msg, NULL, 0, 0)) {
    TranslateMessage(&msg);  // 转换键盘消息
    DispatchMessage(&msg);   // 发送到窗口过程
}
return msg.wParam;

提示：GetMessage在收到WM_QUIT消息时会返回0，结束循环。

4.2 窗口过程函数

所有窗口消息都在WindowProc函数中处理：

c复制LRESULT CALLBACK WindowProc(
    HWND hwnd, UINT uMsg, 
    WPARAM wParam, LPARAM lParam)
{
    switch (uMsg) {
    case WM_DESTROY:
        PostQuitMessage(0);
        return 0;
        
    case WM_PAINT: {
        PAINTSTRUCT ps;
        HDC hdc = BeginPaint(hwnd, &ps);
        // 绘制代码...
        EndPaint(hwnd, &ps);
    } return 0;
    }
    return DefWindowProc(hwnd, uMsg, wParam, lParam);
}

常见消息类型：

• WM_CREATE: 窗口创建时触发
• WM_SIZE: 窗口大小改变
• WM_KEYDOWN: 键盘按键按下
• WM_LBUTTONDOWN: 鼠标左键按下

5. 完整示例代码

下面是一个最小化的完整Win32窗口程序：

c复制#include <windows.h>

LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, 
    WPARAM wParam, LPARAM lParam);

int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, 
    LPSTR lpCmdLine, int nCmdShow)
{
    // 注册窗口类
    WNDCLASS wc