DLGTEMPLATEEX 構造体

[アーティクル]
06/13/2023

拡張ダイアログボックステンプレートは、ダイアログボックスを記述し、ダイアログボックス内のコントロールの数を指定する DLGTEMPLATEEX ヘッダーで始まります。ダイアログボックス内の各コントロールについて、拡張ダイアログボックステンプレートには、 DLGITEMTEMPLATEEX 形式を使用してコントロールを記述するデータブロックがあります。

DLGTEMPLATEEX 構造体は、標準ヘッダーファイルで定義されていません。ダイアログボックスの拡張テンプレートの形式を説明するために、構造定義がここに用意されています。

構文

typedef struct {
  WORD      dlgVer;
  WORD      signature;
  DWORD     helpID;
  DWORD     exStyle;
  DWORD     style;
  WORD      cDlgItems;
  short     x;
  short     y;
  short     cx;
  short     cy;
  sz_Or_Ord menu;
  sz_Or_Ord windowClass;
  WCHAR     title[titleLen];
  WORD      pointsize;
  WORD      weight;
  BYTE      italic;
  BYTE      charset;
  WCHAR     typeface[stringLen];
} DLGTEMPLATEEX;

メンバー

dlgVer

種類: WORD

拡張ダイアログボックステンプレートのバージョン番号。このメンバーは 1 に設定する必要があります。

signature

種類: WORD

テンプレートが拡張ダイアログボックステンプレートであるかどうかを示します。 signature が0xFFFF場合、これは拡張ダイアログボックステンプレートです。この場合、 dlgVer メンバーはテンプレートのバージョン番号を指定します。 signature が0xFFFF以外の値である場合、これは DLGTEMPLATE および DLGITEMTEMPLATE 構造体を使用する標準のダイアログボックステンプレートです。

helpID

型: DWORD

ダイアログボックスウィンドウのヘルプコンテキスト識別子。システムは、WM_HELP メッセージを送信すると、HELPINFO 構造体の wContextId メンバーにこの値を渡します。

exStyle

型: DWORD

拡張ウィンドウスタイル。このメンバーはダイアログボックスの作成時には使用されませんが、ダイアログボックステンプレートを使用するアプリケーションでは、そのメンバーを使用して他の種類のウィンドウを作成できます。値の一覧については、「 拡張ウィンドウのスタイル」を参照してください。

style

型: DWORD

ダイアログボックスのスタイル。このメンバーには、ウィンドウスタイル値とダイアログボックススタイル値の組み合わせを指定できます。

style に DS_SETFONT または DS_SHELLFONT ダイアログボックススタイルが含まれている場合、拡張ダイアログボックステンプレートの DLGTEMPLATEEX ヘッダーには、クライアント領域のテキストとダイアログボックスのコントロールに使用するフォントを記述する 4 つの追加メンバー (pointsize、weight、italic、typeface) が含まれます。可能であれば、これらのメンバーで指定された値に従ってフォントが作成されます。その後、システムはダイアログボックスと各コントロールに WM_SETFONT メッセージを送信して、フォントへのハンドルを提供します。

詳細については、「ダイアログボックスのフォント」を参照してください。

cDlgItems

種類: WORD

ダイアログボックス内のコントロールの数。

x

型: short

ダイアログボックスの左上隅の x 座標 (ダイアログボックス単位)。

y

型: short

ダイアログボックスの左上隅の y 座標 (ダイアログボックス単位)。

cx

型: short

ダイアログボックスの幅 (ダイアログボックス単位)。

cy

型: short

ダイアログボックスの高さ (ダイアログボックス単位)。

menu

種類: sz_Or_Ord

ダイアログボックスのメニューリソースを識別する 16 ビット要素の可変長配列。この配列の最初の要素が0x0000場合、ダイアログボックスにはメニューがなく、配列には他の要素はありません。最初の要素が0xFFFF場合、配列には、実行可能ファイル内のメニューリソースの序数値を指定する 1 つの追加要素があります。最初の要素に他の値がある場合、システムは配列を、実行可能ファイル内のメニューリソースの名前を指定する null で終わる Unicode 文字列として扱います。

windowClass

種類: sz_Or_Ord

ダイアログボックスのウィンドウクラスを識別する 16 ビット要素の可変長配列。配列の最初の要素が0x0000場合、システムはダイアログボックスに定義済みのダイアログボックスクラスを使用し、配列には他の要素はありません。最初の要素が0xFFFFの場合、配列には、定義済みのシステムウィンドウクラスの序数値を指定する 1 つの追加要素があります。最初の要素に他の値がある場合、システムは、登録されたウィンドウクラスの名前を指定する null で終わる Unicode 文字列として配列を扱います。

title

種類: WCHAR[titleLen]

ダイアログボックスのタイトル。この配列の最初の要素が0x0000場合、ダイアログボックスにはタイトルがなく、配列には他の要素はありません。

pointsize

種類: WORD

ダイアログボックスとそのコントロールのテキストに使用するフォントのポイントサイズ。