拡張ダイアログ ボックス テンプレートが拡張ダイアログ ボックスを記述するために使用するテキストブロック。 拡張ダイアログ ボックス テンプレートの形式の説明については、「 DLGTEMPLATEEX」を参照してください。
構文
typedef struct {
DWORD helpID;
DWORD exStyle;
DWORD style;
short x;
short y;
short cx;
short cy;
DWORD id;
sz_Or_Ord windowClass;
sz_Or_Ord title;
WORD extraCount;
} DLGITEMTEMPLATEEX;
メンバー
-
helpID
-
型: DWORD
-
コントロールのヘルプ コンテキスト識別子。 システムは 、WM_HELP メッセージを送信すると、 HELPINFO 構造体の dwContextId メンバーに helpID 値を渡します。
-
exStyle
-
型: DWORD
-
ウィンドウの拡張スタイル。 このメンバーは、ダイアログ ボックスでコントロールを作成するために使用されませんが、ダイアログ ボックス テンプレートを使用するアプリケーションでは、それを使用して他の種類のウィンドウを作成できます。 値の一覧については、「 拡張ウィンドウ のスタイル」を参照してください。
-
style
-
型: DWORD
-
コントロールのスタイル。 このメンバーは、 ウィンドウ スタイル値 ( WS_BORDER など) と 1 つ以上の コントロール スタイル値 ( BS_PUSHBUTTON や ES_LEFTなど) の組み合わせにすることができます。
-
x
-
型: short
-
コントロールの左上隅の x 座標 (ダイアログ ボックス単位)。 この座標は、常にダイアログ ボックスのクライアント領域の左上隅を基準にしています。
-
y
-
型: short
-
コントロールの左上隅の y 座標 (ダイアログ ボックス単位)。 この座標は、常にダイアログ ボックスのクライアント領域の左上隅を基準にしています。
-
cx
-
型: short
-
コントロールの幅 (ダイアログ ボックス単位)。
-
cy
-
型: short
-
コントロールの高さ (ダイアログ ボックス単位)。
-
id
-
型: DWORD
-
コントロール識別子。
-
windowClass
-
種類: sz_Or_Ord
-
コントロールのウィンドウ クラスを指定する 16 ビット要素の可変長配列。 この配列の最初の要素が0xFFFF以外の値である場合、システムは、登録されたウィンドウ クラスの名前を指定する null で終わる Unicode 文字列として配列を扱います。
最初の要素が0xFFFF場合、配列には、定義済みのシステム クラスの序数値を指定する 1 つの追加要素があります。 序数には、次のいずれかの atom 値を指定できます。
値 説明 - 0x0080
Button - 0x0081
編集 - 0x0082
静的 - 0x0083
リスト ボックス - 0x0084
スクロール バー - 0x0085
コンボ ボックス -
title
-
種類: sz_Or_Ord
-
コントロールの初期テキストまたはリソース識別子を含む 16 ビット要素の可変長配列。 この配列の最初の要素が0xFFFF場合、配列には、実行可能ファイル内のアイコンなどのリソースの序数値を指定する 1 つの追加要素があります。 静的アイコン コントロールなど、テキストではなくアイコンやその他のリソースを読み込んで表示するコントロールには、リソース識別子を使用できます。 最初の要素が0xFFFF以外の値である場合、システムは配列を、初期テキストを指定する null で終わる Unicode 文字列として扱います。
-
extraCount
-
種類: WORD
-
このメンバーに続く作成データのバイト数。 この値が 0 より大きい場合、作成データは次の WORD 境界から開始されます。 この作成データは、任意のサイズと形式にすることができます。 コントロールのウィンドウ プロシージャは、データを解釈できる必要があります。 システムは、コントロールを作成するときに、コントロールに送信するWM_CREATE メッセージの lParam パラメーターで、このデータへのポインターを渡します。
解説
ダイアログ ボックスの拡張テンプレートは、 DLGTEMPLATEEX ヘッダーの後に、ダイアログ ボックス内の各コントロールの DLGITEMTEMPLATEEX 構造体で構成されます。
各 DLGITEMTEMPLATEEX 構造体は 、DWORD 境界に配置する必要があります。 可変長 windowClass 配列と タイトル 配列は 、WORD の境界に配置する必要があります。 作成データ配列がある場合は、 WORD の境界に配置する必要があります。
windowClass 配列とタイトル配列で文字列を指定する場合は、Unicode 文字列を使用する必要があります。 MultiByteToWideChar 関数を使用して、ANSI 文字列から Unicode 文字列を生成します。
x、y、cx、cy の各メンバーは、ダイアログ ボックスの単位で値を指定します。 MapDialogRect 関数を使用して、これらの値を画面単位 (ピクセル) に変換できます。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |