コントロール テーブル

コントロール テーブルは、各ダイアログ ボックスに表示されるコントロールを定義します。

Control テーブルには、次の列があります。

Column 種類 キー Nullable
Dialog_ 識別子 Y N
コントロール 識別子 Y N
Type 識別子 N N
X 整数 N N
Y 整数 N N
整数 N N
[高さ] 整数 N N
属性 DoubleInteger N Y
プロパティ 識別子 N Y
Text フォーマット N Y
Control_Next 識別子 N Y
ヘルプ [テキスト] N Y

 

[列]

Dialog_

ダイアログ テーブルの最初の列 (ダイアログ ボックスの名前) の外部キー。

コントロール

コントロールの名前。 この名前はダイアログ ボックス内で一意である必要がありますが、異なるダイアログ ボックスで繰り返すことができます。 コントロール列とDialog_列の組み合わせによって、このテーブルの主キーが形成されます。

コントロールの型。 コントロールの種類の一覧については、「 コントロール」を参照してください。

X

コントロールの四角形の境界の左上隅の水平方向の座標。 これは負以外の数値である必要があります。 「位置コントロールの属性」を参照してください。

Y

コントロールの四角形の境界の左上隅の垂直座標。 これは負以外の数値である必要があります。 「位置コントロールの属性」を参照してください。

コントロールの四角形の境界の幅。 これは負以外の数値である必要があります。 「位置コントロールの属性」を参照してください。

高さ

コントロールの四角形の境界の高さ。 これは負以外の数値である必要があります。 「位置コントロールの属性」を参照してください。

属性

このコントロールに適用するビット フラグを指定する 32 ビット ワード。 これは負以外の数値である必要があり、許可される値はコントロールの種類によって異なります。 すべてのコントロール属性の一覧と、このフィールドに入力する値については、「 コントロール属性」を参照してください。

プロパティ

このコントロールにリンクする定義済みのプロパティの名前。 ラジオ ボタン、リスト ボックス、コンボ ボックスの値は、同じプロパティにリンクすることでグループに関連付けられます。 この列は、アクティブなコントロールに必要です。

テキスト

コントロールに含まれる初期テキストを設定するために使用されるローカライズ可能な文字列。 文字列には、埋め込みプロパティを含めることもできます。 プロパティを含む書式設定された文字列の構文については、 MsiFormatRecord 関数を参照してください。 テキスト文字列の前に {\style} を付けて、テキストのサイズ、フォント、色を指定します。スタイルは TextStyle テーブルの TextStyle 列に作成されたテキスト スタイルです。 長すぎてコントロールに収まらない場合、テキスト文字列は切り捨てられます。 テキスト文字列は空白の場合があります。

TrackDiskpace 属性を持つダイアログ ボックスにあるテキスト コントロールでテキストを表示する場合は、このフィールドの書式設定されたテキスト文字列の特別な作成が必要です。 これは、ダイアログ テーブルの属性に表示される TrackDiskSpace ダイアログ スタイル ビット で指定されたケース です。 この場合、Control テーブルの Text 列の書式設定された文字列が "[" で始まり、"]" で終わる場合は、文字列の末尾にスペースを追加する必要があります。 たとえば、DlgTextFont が "{\DlgFontBold}" に設定されるプロパティの場合、書式設定された文字列 "[DlgTextFont]MyText[ProductName] " の末尾には右角かっこの後にスペースが必要です。 この余分な領域は、テキスト コントロールにテキストを正しく表示するためにインストーラーによって必要です。

VolumeCostListListViewDirectoryListおよび SelectionTree コントロールの短い説明テキスト文字列を入力できます。 このテキストはユーザーには表示されませんが、スクリーン リーダーがコントロールの説明として読み取ることができます。

アクセシビリティ」も参照してください。

Control_Next

同じダイアログ ボックス上の別のコントロールの名前と、コントロール テーブルの 2 番目の列の外部キー。 ダイアログ ボックスのフォーカスが [コントロール] 列のコントロールにある場合は、タブ キーを押すと、Control_Next列に一覧表示されているコントロールにフォーカスが移動します。 したがって、この列は、ダイアログ ボックスのコントロールのタブ オーダーを指定するために使用されます。 コントロール間のリンクは、閉じたサイクルを形成する必要があります。 静的テキスト コントロールなどの一部のコントロールは、サイクル外に残すことができます。 この場合、このフィールドは空白のままにすることができます。

アクセシビリティ」も参照してください。

ヘルプ

[ヘルプ] ボタンで使用される、ローカライズ可能なオプションのテキスト文字列。 文字列は、区切り文字 (|) によって 2 つの部分に分割されます。 文字列の最初の部分は、ツールヒント テキストとして使用されます。 このテキストは、画像を含むコントロールのスクリーン リーダーによって使用されます。 文字列の 2 番目の部分は、将来使用するために予約されています。 2 種類のテキストのいずれかが存在する場合でも、区切り文字が必要です。

解説

x、y、幅、および高さの整数値は、ダイアログ ユニットではなくインストーラーユニットにあります。 インストーラー ユニットは、10 ポイントの MS Sans Serif フォント サイズの 12 分の 1 の高さに等しくなります。 コントロールの座標は、ビルボードに対する相対座標です。

検証

ICE03
ICE06
ICE17
ICE20
ICE23
ICE31
ICE32
ICE34
ICE45
ICE46
ICE95