Share via

DLGITEMTEMPLATEEX 構造体

  • [アーティクル]

拡張ダイアログ ボックス テンプレートが拡張ダイアログ ボックスを記述するために使用するテキストブロック。 拡張ダイアログ ボックス テンプレートの形式の説明については、「 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 [デスクトップ アプリのみ]

関連項目

参照

CreateDialogIndirect

CreateDialogIndirectParam

CreateWindowEx

DialogBoxIndirect

DialogBoxIndirectParam

DLGTEMPLATEEX

MapDialogRect

Wm_create

概念

ダイアログ ボックス

その他のリソース

MultiByteToWideChar

Wm_help