CREATESTRUCTA 構造体 (winuser.h)

[アーティクル]
11/20/2024

アプリケーションのウィンドウプロシージャに渡される初期化パラメーターを定義します。これらのメンバーは、CreateWindowEx 関数のパラメーターと同じです。

構文

typedef struct tagCREATESTRUCTA {
  LPVOID    lpCreateParams;
  HINSTANCE hInstance;
  HMENU     hMenu;
  HWND      hwndParent;
  int       cy;
  int       cx;
  int       y;
  int       x;
  LONG      style;
  LPCSTR    lpszName;
  LPCSTR    lpszClass;
  DWORD     dwExStyle;
} CREATESTRUCTA, *LPCREATESTRUCTA;

メンバーズ

lpCreateParams

型: LPVOID

ウィンドウの作成に使用できる追加のデータが含まれています。 CreateWindow または CreateWindowEx 関数呼び出しの結果としてウィンドウが作成される場合、このメンバーには、関数呼び出しで指定された lpParam パラメーターの値が含まれます。

作成されるウィンドウが MDI クライアントウィンドウの場合、このメンバーには、CLIENTCREATESTRUCT 構造体へのポインターが含まれます。作成されるウィンドウが MDI 子ウィンドウの場合、このメンバーには、MDICREATESTRUCT 構造体へのポインターが含まれます。

ダイアログテンプレートからウィンドウを作成する場合、このメンバーは、ウィンドウ作成データのサイズ (バイト単位) を指定する SHORT 値のアドレスです。値の直後に作成データが続きます。詳細については、次の「解説」セクションを参照してください。

hInstance

型: HINSTANCE

新しいウィンドウを所有するモジュールのハンドル。

hMenu

型: HMENU

新しいウィンドウで使用するメニューのハンドル。

hwndParent

型: HWND

ウィンドウが子ウィンドウの場合は、親ウィンドウへのハンドル。ウィンドウが所有されている場合、このメンバーは所有者ウィンドウを識別します。ウィンドウが子ウィンドウまたは所有ウィンドウでない場合、このメンバーは NULL。

cy

型: int

新しいウィンドウの高さ (ピクセル単位)。

cx

型: int

新しいウィンドウの幅 (ピクセル単位)。

y

型: int

新しいウィンドウの左上隅の y 座標。新しいウィンドウが子ウィンドウの場合、座標は親ウィンドウを基準とします。それ以外の場合、座標は画面の原点を基準とします。

x

型: int

新しいウィンドウの左上隅の x 座標。新しいウィンドウが子ウィンドウの場合、座標は親ウィンドウを基準とします。それ以外の場合、座標は画面の原点を基準とします。

style

型: long

新しいウィンドウのスタイル。使用可能な値の一覧については、「ウィンドウスタイルの」を参照してください。

lpszName

型: LPCTSTR

新しいウィンドウの名前。

lpszClass

型: LPCTSTR

null で終わる文字列または新しいウィンドウのクラス名を指定するアトムへのポインター。

dwExStyle

型: DWORD

新しいウィンドウの拡張ウィンドウスタイル。使用可能な値の一覧については、「拡張ウィンドウスタイルの」を参照してください。

備考

lpszClass メンバーには、ローカルの (したがってアクセスできない) アトムへのポインターを含めることができるため、このメンバーを使用してクラス名を取得しないでください。代わりに、GetClassName 関数を使用してください。

UNALIGNED 型を使用して宣言されたポインターを使用して、lpCreateParams メンバーによって表されるデータにアクセスする必要があります。これは、ポインターが DWORD アラインされない可能性があるためです。これは、次の例で示されています。

typedef struct tagMyData 
{
    // Define creation data here. 
} MYDATA; 
 
typedef struct tagMyDlgData 
{ 
    SHORT   cbExtra; 
    MYDATA  myData; 
} MYDLGDATA, UNALIGNED *PMYDLGDATA; 
 
PMYDLGDATA pMyDlgdata = (PMYDLGDATA) (((LPCREATESTRUCT) lParam)->lpCreateParams);

手記

winuser.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして CREATESTRUCT を定義します。エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされる最小サーバー	Windows 2000 Server [デスクトップアプリのみ]
ヘッダー	winuser.h (Windows.h を含む)

次の方法で共有

CREATESTRUCTA 構造体 (winuser.h)

構文

メンバーズ

備考

必要条件

関連項目

フィードバック

その他のリソース