DLGTEMPLATE 構造体 (winuser.h)

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

ダイアログボックスの寸法とスタイルを定義します。この構造体は、ダイアログボックスの標準テンプレートの最初の構造であり、ダイアログボックス内のコントロールの数も指定するため、テンプレート内の後続の DLGITEMTEMPLATE 構造体の数を指定します。

構文

typedef struct {
  DWORD style;
  DWORD dwExtendedStyle;
  WORD  cdit;
  short x;
  short y;
  short cx;
  short cy;
} DLGTEMPLATE;

メンバー

style

型: DWORD

ダイアログボックスのスタイル。このメンバーは、ウィンドウスタイル値 ( WS_CAPTION や WS_SYSMENUなど) とダイアログボックスのスタイル値 ( DS_CENTERなど) の組み合わせにすることができます。

スタイルメンバーに DS_SETFONT スタイルが含まれている場合、ダイアログボックステンプレートのヘッダーには、クライアント領域のテキストとダイアログボックスのコントロールに使用するフォントを指定する追加のデータが含まれます。フォントデータは、タイトル配列の後の WORD 境界から始まります。フォントデータは、16 ビットのポイントサイズ値と Unicode フォント名の文字列を指定します。可能であれば、指定した値に従ってフォントが作成されます。その後、システムはダイアログボックスと各コントロールに WM_SETFONT メッセージを送信して、フォントへのハンドルを提供します。 DS_SETFONTが指定されていない場合、ダイアログボックステンプレートにはフォントデータは含まれません。

DS_SHELLFONT スタイルは、DLGTEMPLATE ヘッダーではサポートされていません。

dwExtendedStyle

型: DWORD

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

cdit

種類: WORD

ダイアログボックス内のアイテムの数。

x

型: short

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

y

型: short

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

cx

型: short

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

cy

型: short

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

注釈

ダイアログボックスの標準テンプレートでは、 DLGTEMPLATE 構造体の直後に、ダイアログボックスのメニュー、クラス、タイトルを指定する 3 つの可変長配列が常に続きます。 DS_SETFONT スタイルを指定すると、これらの配列の後に、ポイントサイズを指定する 16 ビット値と、書体名を指定する別の可変長配列も続きます。各配列は、1 つ以上の 16 ビット要素で構成されます。メニュー、クラス、タイトル、およびフォント配列は、 WORD の境界に配置する必要があります。

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

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

クラス配列の後には、ダイアログボックスのタイトルを含む null で終わる Unicode 文字列を指定するタイトル配列があります。この配列の最初の要素が0x0000場合、ダイアログボックスにはタイトルがなく、配列には他の要素はありません。

16 ビットのポイントサイズ値と書体配列はタイトル配列の後に続きますが、スタイルメンバーがDS_SETFONT スタイル を指定している場合に限ります。ポイントサイズの値は、ダイアログボックスとそのコントロールのテキストに使用するフォントのポイントサイズを指定します。書体配列は、フォントの書体の名前を指定する null で終わる Unicode 文字列です。これらの値を指定すると、システムは、指定したサイズと書体 (可能な場合) を持つフォントを作成し、ダイアログボックスとコントロールを作成するときに、ダイアログボックスプロシージャとコントロールウィンドウプロシージャに WM_SETFONT メッセージを送信します。

標準ダイアログボックステンプレートの DLGTEMPLATE ヘッダーの後には、ダイアログボックス内のコントロールの寸法とスタイルを定義する 1 つ以上の DLGITEMTEMPLATE 構造体があります。 cdit メンバーは、テンプレート内の DLGITEMTEMPLATE 構造体の数を指定します。これらの DLGITEMTEMPLATE 構造体は 、DWORD 境界に配置する必要があります。

メニュー、クラス、タイトル、または書体の配列で文字列を指定する場合は、Unicode 文字列を使用する必要があります。

x、y、cx、cy の各メンバーは、ダイアログボックスの単位で値を指定します。 MapDialogRect 関数を使用して、これらの値を画面単位 (ピクセル) に変換できます。

要件

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

DLGTEMPLATE 構造体 (winuser.h)

構文

メンバー

注釈

要件

関連項目

フィードバック

フィードバック

その他のリソース