CreateWindowA マクロ (winuser.h)

重なるウィンドウ、ポップアップ ウィンドウ、または子ウィンドウを作成します。 ウィンドウ クラス、ウィンドウ タイトル、ウィンドウ スタイル、および (必要に応じて) ウィンドウの初期位置とサイズを指定します。 この関数は、ウィンドウの親または所有者 (存在する場合) とウィンドウのメニューも指定します。

CreateWindowでサポートされているスタイルに加えて、拡張ウィンドウ スタイル 使用するには、CreateWindowEx 関数 使用します。

構文

HWND CreateWindowA(
  [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, optional] lpClassName

型: LPCSTR を

null-terminated 文字列、または RegisterClass または registerClassEx 関数への以前の呼び出しによって作成されたクラス アトム 。 atom は、lpClassNameの下位ワード 含まれている必要があります。高次ワードはゼロでなければなりません。 lpClassName が文字列の場合は、ウィンドウ クラス名を指定します。 クラスを登録するモジュールがウィンドウを作成するモジュールでもある場合、クラス名には、RegisterClass または RegisterClassExに登録されている任意の名前を指定できます。 クラス名には、定義済みのシステム クラス名を指定することもできます。 システム クラス名の一覧については、「解説」セクションを参照してください。

[in, optional] lpWindowName

型: LPCSTR を

ウィンドウ名。 ウィンドウ スタイルでタイトル バーが指定されている場合、lpWindowName 指すウィンドウ タイトルがタイトル バーに表示されます。 CreateWindow を使用してボタン、チェック ボックス、静的コントロールなどのコントロールを作成する場合は、lpWindowName 使用してコントロールのテキストを指定します。 SS_ICON スタイルで静的コントロールを作成する場合は、lpWindowName 使用してアイコンの名前または識別子を指定します。 識別子を指定するには、構文 "#num" を使用します。

[in] dwStyle

型: DWORD

作成するウィンドウのスタイル。 このパラメーターには、ウィンドウ スタイル値と、「解説」セクションで示されているコントロール スタイルの組み合わせを指定できます。

[in] x

型: int

ウィンドウの最初の水平位置。 重なったウィンドウまたはポップアップ ウィンドウの場合、x パラメーターは、ウィンドウの左上隅の最初の x 座標 (画面座標) です。 子ウィンドウの場合、x は、親ウィンドウのクライアント領域の左上隅を基準としたウィンドウの左上隅の x 座標です。 このパラメーターが CW_USEDEFAULTに設定されている場合、システムはウィンドウの左上隅の既定の位置を選択し、y パラメーターを無視します。 CW_USEDEFAULT は、重複するウィンドウに対してのみ有効です。ポップアップ ウィンドウまたは子ウィンドウに指定されている場合、x パラメーターと y パラメーターは 0 に設定されます。

[in] y

型: int

ウィンドウの最初の垂直方向の位置。 重なったウィンドウまたはポップアップ ウィンドウの場合、y パラメーターは、ウィンドウの左上隅の初期 y 座標 (画面座標) です。 子ウィンドウの場合、y は、親ウィンドウのクライアント領域の左上隅を基準とした子ウィンドウの左上隅の最初の y 座標です。 リスト ボックスの場合、y は、親ウィンドウのクライアント領域の左上隅を基準とした、リスト ボックスのクライアント領域の左上隅の最初の y 座標です。

WS_VISIBLE スタイル ビット が設定された重なり合ったウィンドウが作成され、x パラメーターが CW_USEDEFAULTに設定されている場合、y パラメーターによってウィンドウの表示方法が決まります。 y パラメーターが CW_USEDEFAULTされている場合、ウィンドウ マネージャーは、ウィンドウの作成後に SW_SHOW フラグ ShowWindow を呼び出します。 y パラメーターが他の値である場合、ウィンドウ マネージャーはその値を nCmdShow パラメーターとして ShowWindow を呼び出します。

[in] nWidth

型: int

ウィンドウの幅 (デバイス単位)。 重複するウィンドウの場合、nWidth は、ウィンドウの幅、画面座標、または CW_USEDEFAULTのいずれかです。 nWidth CW_USEDEFAULT場合、ウィンドウの既定の幅と高さが選択されます。既定の幅は最初の x 座標から画面の右端まで、既定の高さは初期の y 座標からアイコン領域の上部まで拡張されます。 CW_USEDEFAULT は、重複するウィンドウに対してのみ有効です。ポップアップ ウィンドウまたは子ウィンドウに CW_USEDEFAULT が指定されている場合は、nWidth と nHeight が 0 に設定されます。

[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

WM_CREATE メッセージの lParam パラメーターが指す CREATESTRUCT 構造体 (lpCreateParams メンバー) を介してウィンドウに渡される値へのポインター。 このメッセージは、戻る前に、この関数によって作成されたウィンドウに送信されます。

アプリケーション CreateWindow を呼び出して MDI クライアント ウィンドウを作成する場合、lpParam は、CLIENTCREATESTRUCT 構造体を指す必要があります。 MDI クライアント ウィンドウが CreateWindow 呼び出して MDI 子ウィンドウを作成する場合、lpParam は、MDICREATESTRUCT 構造体を指す必要があります。 lpParam 、追加のデータが必要ない場合は NULL 可能性があります。

戻り値

型: HWND

関数が成功した場合、戻り値は新しいウィンドウへのハンドルです。

関数が失敗した場合、戻り値は NULL。 拡張エラー情報を取得するには、GetLastError呼び出します。

備考

戻る前に、CreateWindow WM_CREATE メッセージをウィンドウ プロシージャに送信します。 重複するウィンドウ、ポップアップ ウィンドウ、および子ウィンドウの場合は、CreateWindow WM_CREATE、WM_GETMINMAXINFO、および WM_NCCREATE メッセージをウィンドウに送信します。 WM_CREATE メッセージの lParam パラメーターには、CREATESTRUCT 構造体へのポインターが含まれています。 WS_VISIBLE スタイルが指定されている場合、CreateWindow は、アクティブ化してウィンドウを表示するために必要なすべてのメッセージをウィンドウに送信します。

作成されたウィンドウが子ウィンドウの場合、既定の位置は Z オーダーの一番下にあります。 作成されたウィンドウが最上位ウィンドウの場合、既定の位置は Z オーダーの一番上にあります (ただし、作成されたウィンドウ自体が最上位でない限り、最上位のすべてのウィンドウの下)。

タスク バーに作成されたウィンドウのボタンを表示するかどうかを制御する方法については、「タスク バー ボタンの管理 を参照してください。

ウィンドウを削除する方法については、DestroyWindow 関数 参照してください。

lpClassName パラメーターには、次の定義済みシステム クラスを指定できます。 dwStyle パラメーターで使用できる対応するコントロール スタイルに注意してください。

CreateWindow は、次に示すように、CreateWindowEx 関数の呼び出しとして実装されます。

#define CreateWindowA(lpClassName, lpWindowName, dwStyle, x, y, nWidth, nHeight, hWndParent, hMenu, hInstance, lpParam)\
CreateWindowExA(0L, lpClassName, lpWindowName, dwStyle, x, y, nWidth, nHeight, hWndParent, hMenu, hInstance, lpParam)

#define CreateWindowW(lpClassName, lpWindowName, dwStyle, x, y, nWidth, nHeight, hWndParent, hMenu, hInstance, lpParam)\
CreateWindowExW(0L, lpClassName, lpWindowName, dwStyle, x, y, nWidth, nHeight, hWndParent, hMenu, hInstance, lpParam)

#ifdef UNICODE
#define CreateWindow  CreateWindowW
#else
#define CreateWindow  CreateWindowA
#endif

例

例については、「ウィンドウ クラスの使用 」を参照してください。

必要条件

関連項目

複数のドキュメント インターフェイスの について

共通コントロール ウィンドウ クラス

概念

CreateWindowEx の

DestroyWindow の

EnableWindow の

その他のリソース を する

リファレンス

RegisterClass の

RegisterClassEx の

ShowWindow の

WM_COMMAND

WM_CREATE

WM_GETMINMAXINFO

WM_NCCREATE

WM_PAINT

Windows の