一般的なコントロール パラメーター

次に、制御リソース定義ステートメントの一般的な構文について説明します。 各パラメーターの意味を次に示します。 ステートメントでパラメーターが異なる方法で使用されたり、パラメーターが無視されたりすることがあります。 ステートメント固有のバリエーションについては、 ステートメントのドキュメントで説明されています。

control [[text,]] id, x, y, width, height[[, style[[, extended-style]]]][, helpId]
[{ data-element-1 [, data-element-2 [,  . . . ]]}]

テキスト

コントロールと共に表示されるテキスト。 テキストはコントロール内に配置されるか、コントロールの隣に配置されます。

このパラメーターには、0 個以上の文字を二重引用符 (") で囲む必要があります。 文字列は自動的に null で終了し、結果のリソース ファイルで Unicode に変換されます。

既定では、二重引用符の間に一覧表示される文字は ANSI 文字であり、エスケープ シーケンスはバイト エスケープ シーケンスとして解釈されます。 文字列の前に "L" プレフィックスが付いている場合、文字列はワイド文字列であり、エスケープ シーケンスは Unicode 文字を指定する 2 バイトのエスケープ シーケンスとして解釈されます。 テキストに二重引用符が必要な場合は、二重引用符を 2 回含める必要があります。

テキスト内のアンパサンド (&) 文字は、次の文字がコントロールのニーモニック文字として使用されることを示します。 コントロールが表示されると、アンパサンドは表示されませんが、ニーモニック文字は下線付きになります。 ユーザーは、下線付きニーモニック文字に対応するキーを押すことで、コントロールを選択できます。 アンパサンドを文字列の文字として使用するには、2 つのアンパサンド (&&) を挿入します。

Id

コントロール ID です。 この値は、0 ~ 65,535 の範囲の 16 ビット符号なし整数、またはその範囲内の値に評価される単純な算術式である必要があります。

X

ダイアログ ボックスの左側を基準としたコントロールの左側の X 座標。 この値は、0 ~ 65,535 の範囲の 16 ビット符号なし整数である必要があります。 座標はダイアログ単位で、指定したコントロールを含むダイアログ ボックス、ウィンドウ、またはコントロールの原点を基準にしています。

Y

ダイアログ ボックスの上部を基準としたコントロールの上端の Y 座標。 この値は、0 ~ 65,535 の範囲の 16 ビット符号なし整数である必要があります。 座標は、指定したコントロールを含むダイアログ ボックス、ウィンドウ、またはコントロールの原点を基準にして、ダイアログ単位で表示されます。

幅

コントロールの幅。 この値は、1 ~ 65,535 の範囲の 16 ビット符号なし整数である必要があります。 幅は 1/4 文字単位です。

高さ

コントロールの高さ。 この値は、1 ~ 65,535 の範囲の 16 ビット符号なし整数である必要があります。 高さは 1/8 文字単位です。

スタイル

コントロール のスタイル。 スタイルを結合するには、ビットごとの OR (|) 演算子を使用します。 詳細については、「ウィンドウ スタイル」を参照してください。

extended-style

拡張ウィンドウ スタイル。 拡張スタイルを指定するには、style を指定する必要があります。 詳細については、「 EXSTYLE」を参照してください。

helpId

WM_HELP処理中にコントロールを識別するために使用される ID を示す数値式。

controlData

コントロールのコントロール固有のデータ。 ダイアログが作成され、そのダイアログにコントロール固有のデータを含むコントロールが作成されると、そのコントロールの WM_CREATE メッセージの lParam を介して、そのデータへのポインターがコントロールのウィンドウ プロシージャに渡されます。

注釈

水平ダイアログの単位は、ダイアログの基本幅の単位の 1/4 です。 垂直単位は、ダイアログ ベースの高さの単位の 1/8 です。 現在のダイアログの基本単位は、現在のシステム フォントの高さと幅から計算されます。 GetDialogBaseUnits 関数は、ダイアログの基本単位をピクセル単位で返します。 座標は、ダイアログ ボックスの原点に対して相対的です。