Windows SDK 筆記（二）：視窗建立控制項完整指南與類別名稱大全

控制項基本概念

控制項是子視窗，屬於系統預定義視窗類別，無需註冊、無需撰寫訊息處理函式。在主視窗 WM_CREATE 訊息中建立即可。

建立控制項標準範例

LRESULT CALLBACK WndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)
{
    switch (message)
    {
        case WM_CREATE:
            CreateWindow(TEXT("BUTTON"),        // 控制項類別名稱
                TEXT("按鈕(&A)"),
                WS_CHILD | WS_VISIBLE | BS_PUSHBUTTON,
                10, 10, 100, 100,
                hwnd,
                (HMENU)1000,                    // 控制項 ID
                ((LPCREATESTRUCT)lParam)->hInstance,
                NULL);
            return 0;

        case WM_DESTROY:
            PostQuitMessage(0);
            return 0;
    }
    return ::DefWindowProc(hwnd, message, wParam, lParam);
}

WM_CREATE 訊息參數詳解

lParam 指向 CREATESTRUCT 結構，包含視窗建立參數：

typedef struct tagCREATESTRUCT {
    LPVOID lpCreateParams;
    HINSTANCE hInstance;      // 實例控制代碼
    HMENU hMenu;
    HWND hwndParent;
    int cy, cx, y, x;
    LONG style;
    LPCTSTR lpszName;
    LPCTSTR lpszClass;
    DWORD dwExStyle;
} CREATESTRUCT, *LPCREATESTRUCT;

控制項與父視窗協作機制

1. 控制項通知父視窗：WM_COMMAND

• HIWORD(wParam)：通知代碼
• LOWORD(wParam)：控制項 ID
• (HWND)lParam：控制項控制代碼

特定控制項另有專用通知訊息（如 WM_DRAWITEM）。

2. 父視窗控制控制項

記錄控制項控制代碼或透過 ID 取得（GetDlgItem），發送控制項專用訊息。

3. 參考文件位置

MSDN → Platform SDK → User Interface Services → Windows User Interface → Controls

控制項類別名稱完整參考表

1. 標準控制項

2. 通用控制項（需 InitCommonControlsEx 初始化）

INITCOMMONCONTROLSEX icex;
icex.dwSize = sizeof(INITCOMMONCONTROLSEX);
icex.dwICC = ICC_LISTVIEW_CLASSES;  // 或其他 ICC_* 旗標
InitCommonControlsEx(&icex);

HWND hWndListView = CreateWindowEx(0, WC_LISTVIEW,  // 無需引號
    TEXT(""),
    WS_CHILD | WS_VISIBLE | WS_BORDER | LVS_ICON | LVS_EDITLABELS | WS_EX_CLIENTEDGE,
    10, 10, 100, 100,
    hwnd, (HMENU)1000,
    ((LPCREATESTRUCT)lParam)->hInstance, NULL);

3. 特殊系統視窗類別

實用技巧：動態建立與配置控制項

// 執行期建立編輯方塊
HWND hEdit = CreateWindowEx(WS_EX_CLIENTEDGE, "EDIT", NULL,
    WS_CHILD | WS_VISIBLE | WS_TABSTOP | ES_AUTOHSCROLL,
    x, y, width, height, hwnd, (HMENU)IDC_EDIT1, hInst, NULL);

// 設定字型
SendMessage(hEdit, WM_SETFONT, (WPARAM)GetStockObject(DEFAULT_GUI_FONT), TRUE);

// 設定提示文字 (Win7+)
SendMessage(hEdit, EM_SETCUEBANNER, TRUE, (LPARAM)L"請輸入關鍵字...");

常見錯誤避雷指南

• 忘記 InitCommonControlsEx：通用控制項建立失敗、外觀異常
• 控制項 ID 衝突：同一父視窗下 ID 必須唯一
• WS_CHILD 遺漏：控制項不會隨父視窗移動/銷毀
• Unicode/ANSI 不匹配：類別名稱與專案字元集設定需一致
• 未處理 WM_GETMINMAXINFO：包含控制項的視窗最小化異常