開發環境與工具

• IDE：Code::Blocks（亦可選用 Visual C++ 或其他 IDE）。

• 編譯器：GCC（MinGW）或 Microsoft VC++（MSVC）。

• 項目類型：

  • Win32 GUI 項目：含模板代碼，自動鏈接所需庫。
  • Console 項目：需手動包含 <windows.h > f，適合理解底層調用。

• ---

包含頭文件與入口函數（WinMain 詳解）

在源文件頂部添加 注冊窗口類 所需的頭：

#include 

Win32 GUI 程序的入口函數不是 main，而是：

int WINAPI WinMain(
    HINSTANCE hInstance,      // 應用實例句柄
    HINSTANCE hPrevInstance,  // 上一個實例（忽略）
    LPSTR     lpCmdLine,      // 命令行參數
    int       nShowCmd        // 窗口顯示方式
);

• WINAPI：調用約定（__stdcall）。

• 四個參數分別提供應用實例、舊實例、命令行字符串和啟動時窗口狀態。

• ---

測試 Win32 API 可用性（MessageBox 使用方法）

在 WinMain 中插入以下代碼，驗證 Win32 API 教程 環境是否就緒：

MessageBox(
    nullptr,            // 無父窗口
    "Hello, Win32!",    // 消息文本
    "First GUI",        // 窗口標題
    MB_OK               // OK 按鈕
);
return 0;

編譯并運行后，你將看到一個帶 “OK” 按鈕的對話框。

注冊窗口類（RegisterClass 示例）

要創建真正的窗口，需先定義并注冊一個 窗口類（WNDCLASSEXW）：

1. 初始化結構體

   WNDCLASSEXW wc = {0};

2. 設置必要成員

   wc.cbSize        = sizeof(WNDCLASSEXW);
   wc.style         = CS_HREDRAW | CS_VREDRAW;
   wc.lpfnWndProc   = WndProc;                          // 窗口過程
   wc.hInstance     = hInstance;                        // 應用實例
   wc.hCursor       = LoadCursor(nullptr, IDC_ARROW);   // 默認箭頭光標
   wc.hbrBackground = GetSysColorBrush(COLOR_WINDOW);   // 默認背景色
   wc.lpszClassName = L"MyWindowClass";                 // 類名

3. 注冊窗口類

   if (!RegisterClassExW(&wc)) {
    MessageBox(nullptr, "注冊窗口類失敗！", "Error", MB_ICONERROR);
    return -1;
   }

創建窗口（CreateWindow 示例）

注冊成功后，使用 CreateWindowW 創建一個可見的 Windows GUI 編程 窗口：

HWND hwnd = CreateWindowW(
    L"MyWindowClass",                 // 窗口類名
    L"My First Window",               // 窗口標題
    WS_OVERLAPPEDWINDOW | WS_VISIBLE, // 窗口樣式
    100, 100, 500, 500,               // 位置與大小
    nullptr, nullptr, nullptr, nullptr
);
if (!hwnd) {
    MessageBox(nullptr, "創建窗口失敗！", "Error", MB_ICONERROR);
    return -1;
}

消息循環（Message Loop）

窗口創建后必須進入 消息循環，否則程序會立即退出：

MSG msg;
while (GetMessage(&msg, nullptr, 0, 0)) {  // 獲取消息
    TranslateMessage(&msg);                // 翻譯鍵盤消息
    DispatchMessage(&msg);                 // 派發給窗口過程
}

• GetMessage：獲取消息，返回 FALSE 時退出循環。

• TranslateMessage & DispatchMessage：確保消息正確處理。

• ---

窗口過程（DefWindowProc 默認消息處理）

定義 WndProc 回調，實現 __WM_DESTROY 處理__ 等：

LRESULT CALLBACK WndProc(
    HWND   hwnd,
    UINT   uMsg,
    WPARAM wParam,
    LPARAM lParam
) {
    switch (uMsg) {
    case WM_DESTROY:
        PostQuitMessage(0);  // 退出消息循環
        return 0;
    default:
        return DefWindowProcW(hwnd, uMsg, wParam, lParam);
    }
}

• PostQuitMessage：讓 GetMessage 返回 FALSE，結束程序。

• DefWindowProc：默認處理所有未自定義的消息。

• ---

編譯與運行

1. 修復可能的編譯錯誤（如逗號、括號錯誤）。
2. 重新編譯并運行后，你將看到一個可以 調整大小、最小化、關閉 的基礎窗口。

總結與下一步

• 完成了從包含 < windows.h > 、WinMain 詳解、MessageBox 使用方法 到 注冊窗口類、CreateWindow 示例、消息循環、DefWindowProc 默認消息處理 的完整流程。

本文選自YouTube視頻：https://www.youtube.com/watch?v=8GCvZs55mEM