CreateWindowExA 函式 （winuser.h）

建立具有延伸窗口樣式的重疊、彈出視窗或子視窗;否則，此函式與 createWindow 函式 相同。 如需建立視窗的詳細資訊，以及 CreateWindowEx 之其他參數的完整描述，請參閱 CreateWindow。

語法

HWND CreateWindowExA(
  [in]           DWORD     dwExStyle,
  [in, optional] LPCSTR    lpClassName,
  [in, optional] LPCSTR    lpWindowName,
  [in]           DWORD     dwStyle,
  [in]           int       X,
  [in]           int       Y,
  [in]           int       nWidth,
  [in]           int       nHeight,
  [in, optional] HWND      hWndParent,
  [in, optional] HMENU     hMenu,
  [in, optional] HINSTANCE hInstance,
  [in, optional] LPVOID    lpParam
);

參數

[in] dwExStyle

類型：DWORD

正在建立之視窗的延伸窗口樣式。 如需可能值的清單，請參閱擴充窗口樣式。

[in, optional] lpClassName

類型：LPCTSTR

null終止字串或類別 atom。

如果 null-terminated 字串，它會指定視窗類別名稱。 類別名稱可以是向 registerClass 註冊的任何名稱，或 RegisterClassEx 函式註冊，前提是註冊類別的模組也是建立窗口的模組。 類別名稱也可以是任何預先定義的 系統類別 名稱。

如果先前呼叫 RegisterClass 或 RegisterClassEx所建立的類別 atom，則必須使用MAKEINTATOM巨集 轉換。 （atom 必須是 lpClassName的低序字組;高階字必須是零。

[in, optional] lpWindowName

類型：LPCTSTR

視窗名稱。 如果視窗樣式指定標題列，則會在標題列中顯示 lpWindowName 指向的視窗標題。 使用 CreateWindow 建立控件時，例如按鈕、複選框和靜態控件，請使用 lpWindowName 來指定控件的文字。 使用 SS_ICON 樣式建立靜態控件時，請使用 lpWindowName 來指定圖示名稱或標識符。 若要指定識別碼，請使用語法 「#num」。

[in] dwStyle

類型：DWORD

正在建立之窗口的樣式。 這個參數可以是 視窗樣式值的組合，再加上一節中指示的控件樣式。

[in] X

類型：int

視窗的初始水準位置。 對於重疊或彈出視窗，x 參數是視窗左上角的初始 x 座標，以螢幕座標表示。 針對子視窗，x 是視窗左上角相對於父視窗工作區左上角的 X 座標。 如果 x 設定為 CW_USEDEFAULT，系統會選取視窗左上角的預設位置，並忽略 y 參數。 CW_USEDEFAULT 僅適用於重疊的視窗;如果為彈出視窗或子視窗指定，x 和 y 參數會設定為零。

[in] Y

類型：int

視窗的初始垂直位置。 對於重疊或彈出視窗，y 參數是視窗左上角的初始 Y 座標，以螢幕座標表示。 針對子視窗，y 是子視窗左上角相對於父視窗工作區左上角的初始 Y 座標。 對於清單框 y 是清單框工作區左上角相對於父視窗工作區左上角的初始 Y 座標。

如果使用設定 WS_VISIBLE 樣式位建立重疊的視窗，且 x 參數設定為 CW_USEDEFAULT，則 y 參數會決定視窗的顯示方式。 如果 y 參數是 CW_USEDEFAULT，則視窗 管理員會在建立窗口之後，使用 SW_SHOW 旗標呼叫 showWindow。 如果 y 參數是一些其他值，則視窗管理員會呼叫 ShowWindow，並將該值當做 nCmdShow 參數 。

[in] nWidth

類型：int

視窗的寬度，以裝置單位為單位。 對於重疊的視窗，nWidth 是視窗的寬度、螢幕座標或 CW_USEDEFAULT。 如果 nWidth 為 CW_USEDEFAULT，系統會選取視窗的默認寬度和高度;默認寬度會從初始 x 座標延伸至螢幕右邊緣;預設高度會從初始 Y 座標延伸至圖示區域的頂端。 CW_USEDEFAULT 僅適用於重疊的視窗;如果為彈出視窗或子視窗指定 CW_USEDEFAULT，nWidth，且 nHeight 參數會設定為零。

[in] nHeight

類型：int

視窗的高度，以裝置單位為單位。 對於重疊的視窗，nHeight 是視窗的高度，以螢幕座標表示。 如果 nWidth 參數設定為 CW_USEDEFAULT，則系統會忽略 nHeight。

[in, optional] hWndParent

類型：HWND

所建立視窗之父視窗或擁有者視窗的句柄。 若要建立子視窗或擁有的視窗，請提供有效的視窗句柄。 這個參數是彈出視窗的選擇性參數。

若要建立 僅限訊息視窗，請提供 HWND_MESSAGE 或現有僅限訊息視窗的句柄。

[in, optional] hMenu

類型：HMENU

功能表的句柄，或根據視窗樣式指定子視窗標識符。 對於重疊或彈出視窗，hMenu 會識別要與視窗搭配使用的功能表;如果要使用類別功能表，它可以 NULL。 針對子視窗，hMenu 會指定子視窗標識碼，這是對話框控件用來通知其父代事件的整數值。 應用程式會決定子視窗識別碼;對於具有相同父視窗的所有子視窗而言，它必須是唯一的。

[in, optional] hInstance

類型：HINSTANCE

要與視窗相關聯之模組實例的句柄。

[in, optional] lpParam

類型：LPVOID

要透過 CREATESTRUCT 結構（lpCreateParams 成員）指向的值指標，由 WM_CREATE 訊息的 lParam 參數所指向。 此訊息會在傳回之前，由此函式傳送至所建立的視窗。

如果應用程式呼叫 CreateWindow 來建立 MDI 用戶端視窗，lpParam 應該指向 CLIENTCREATESTRUCT 結構。 如果 MDI 用戶端視窗呼叫 CreateWindow 來建立 MDI 子視窗，lpParam 應該指向 MDICREATESTRUCT 結構 。 如果不需要額外的數據，lpParam 可能會 NULL。

傳回值

類型：HWND

如果函式成功，傳回值就是新視窗的句柄。

如果函式失敗，則傳回值 NULL。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

此函式通常會因為下列其中一個原因而失敗：

• 無效的參數值
• 系統類別是由不同的模塊註冊
• 已安裝 WH_CBT 攔截，並傳回失敗碼
• 如果未註冊對話框範本中的其中一個控件，或其視窗視窗程式 WM_CREATE 或 WM_NCCREATE

言論

CreateWindowEx 函式會將 WM_NCCREATE、WM_NCCALCSIZE和 WM_CREATE 訊息傳送至所建立的視窗。

如果建立的視窗是子視窗，則其預設位置位於 Z 順序的底部。 如果建立的視窗是最上層視窗，其預設位置會位於 Z 順序的頂端（但除非建立的視窗本身是最上層的視窗底下）。

如需控制工作列是否顯示已建立視窗按鈕的資訊，請參閱 管理工作列按鈕。

如需移除視窗的資訊，請參閱 DestroyWindow 函式。

您可以在 lpClassName 參數中指定下列預先定義的控件類別。 請注意您可以在 dwStyle 參數中使用的對應控件樣式。

dwExStyle 的 WS_EX_NOACTIVATE 值可防止系統前景啟用。 若要在使用者按兩下視窗時防止佇列啟用，您必須適當地處理 WM_MOUSEACTIVATE 訊息。 若要將視窗帶入前景，或以程式設計方式啟用視窗，請使用 setForegroundWindow 或 SetActiveWindow。 傳回 FALSE 至 WM_NCACTIVATE 可防止視窗失去佇列啟用。 不過，在啟用時會忽略傳回值。

設定 WS_EX_COMPOSITED 之後，視窗的所有子系都會使用雙緩衝來取得由下到上繪製順序。 從下到上繪製順序可讓子代視窗具有半透明（Alpha）和透明度（色彩索引鍵）效果，但只有在子代視窗也已設定 WS_EX_TRANSPARENT 位時。 雙緩衝可讓視窗及其子系繪製而不閃爍。

例

下列範例程式代碼說明如何使用 CreateWindowExA。

BOOL Create(
        PCWSTR lpWindowName,
        DWORD dwStyle,
        DWORD dwExStyle = 0,
        int x = CW_USEDEFAULT,
        int y = CW_USEDEFAULT,
        int nWidth = CW_USEDEFAULT,
        int nHeight = CW_USEDEFAULT,
        HWND hWndParent = 0,
        HMENU hMenu = 0
        )
    {
        WNDCLASS wc = {0};

        wc.lpfnWndProc   = DERIVED_TYPE::WindowProc;
        wc.hInstance     = GetModuleHandle(NULL);
        wc.lpszClassName = ClassName();

        RegisterClass(&wc);

        m_hwnd = CreateWindowEx(
            dwExStyle, ClassName(), lpWindowName, dwStyle, x, y,
            nWidth, nHeight, hWndParent, hMenu, GetModuleHandle(NULL), this
            );

        return (m_hwnd ? TRUE : FALSE);
    }

要求

另請參閱

關於多個檔介面

CLIENTCREATESTRUCT

CREATESTRUCT

概念

CreateWindow

DestroyWindow

EnableWindow

其他資源

參考

RegisterClass

RegisterClassEx

SetActiveWindow

SetForegroundWindow

SetWindowLong

SetWindowPos

ShowWindow

WM_CREATE

WM_NCCALCSIZE

WM_NCCREATE

WM_PAINT

WM_PARENTNOTIFY

Windows