コントロール テーブル
Control テーブルは、各ダイアログ ボックスに表示されるコントロールを定義します。
Control テーブルには、次の列があります。
| コラム | 種類 | 鍵 | 許容 |
|---|---|---|---|
| ] ダイアログ_ | 識別子の | Y | N |
| コントロール | 識別子の | Y | N |
| 種類 | 識別子の | N | N |
| X | 整数 の | N | N |
| Y | 整数 の | N | N |
| 幅 | 整数 の | N | N |
| 高さ | 整数 の | N | N |
| 属性 | DoubleInteger を する | N | Y |
| 財産 | 識別子の | N | Y |
| テキスト | 書式設定された | N | Y |
| Control_Next | 識別子の | N | Y |
| ヘルプ | テキスト | N | Y |
列
-
Dialog_
-
Dialog テーブルの最初の列の外部キー、ダイアログ ボックスの名前。
-
コントロール
-
コントロールの名前。 この名前は、ダイアログ ボックス内で一意である必要がありますが、異なるダイアログ ボックスで繰り返すことができます。 Control 列と Dialog_ 列を組み合わせると、このテーブルの主キーが形成されます。
-
の種類
-
コントロールの型。 コントロールの種類の一覧については、「コントロールの」を参照してください。
-
X
-
コントロールの四角形の境界の左上隅の水平方向の座標。 これは負以外の数値である必要があります。 「位置制御属性 を参照してください。
-
Y
-
コントロールの四角形の境界の左上隅の垂直座標。 これは負以外の数値である必要があります。 「位置制御属性 を参照してください。
-
幅
-
の高さ
-
属性
-
このコントロールに適用するビット フラグを指定する 32 ビット ワード。 これは負以外の数値である必要があり、使用できる値はコントロールの種類によって異なります。 すべてのコントロール属性の一覧と、このフィールドに入力する値については、「コントロール属性を参照してください。
-
プロパティ
-
このコントロールにリンクする定義済みプロパティの名前。 ラジオ ボタン、リスト ボックス、コンボ ボックスの値は、同じプロパティにリンクされることでグループに関連付けられます。 この列は、アクティブなコントロールに必要です。
-
テキスト
-
コントロールに含まれる初期テキストを設定するために使用されるローカライズ可能な文字列。 文字列には、埋め込みプロパティを含めることもできます。 プロパティを含む書式設定された文字列の構文については、MsiFormatRecord 関数を参照してください。 テキスト文字列の前に {\style} を付けて、テキストのサイズ、フォント、色を指定します。ここで、スタイルは、TextStyle テーブルの TextStyle 列に作成されたテキスト スタイルです。 長すぎてコントロールに収まらない場合、テキスト文字列は切り捨てられます。 テキスト文字列は空白の場合があります。
TrackDiskpace 属性を持つダイアログ ボックスにある テキスト コントロール でテキストを表示する場合は、このフィールドの 書式設定された テキスト文字列を特別に作成する必要があります。 これは、TrackDiskSpace ダイアログ スタイル ビットで指定、ダイアログ テーブルの属性に表示されます。 この場合、Control テーブルの Text 列の書式設定された文字列が "[" で始まり、"]" で終わる場合は、文字列の末尾にスペースを追加する必要があります。 たとえば、DlgTextFont が "{\DlgFontBold}" に設定されるプロパティの場合、書式設定された文字列 "[DlgTextFont]MyText[ProductName] " には、終わり角かっこの後の末尾にスペースが必要です。 この余分な領域は、テキスト コントロールにテキストを正しく表示するためにインストーラーによって必要です。
VolumeCostList、ListView、DirectoryList、および SelectionTree コントロールの短い説明テキスト文字列入力できます。 このテキストはユーザーには表示されませんが、スクリーン リーダーがコントロールの説明として読み取ることができます。
アクセシビリティ のも参照してください。
-
Control_Next
-
同じダイアログ ボックス上の別のコントロールの名前と、コントロール テーブルの 2 番目の列の外部キー。 ダイアログ ボックスのフォーカスが [コントロール] 列のコントロールにある場合、タブ キーを押すと、フォーカスが [Control_Next] 列に一覧表示されているコントロールに移動します。 したがって、この列は、ダイアログ ボックスのコントロールのタブ オーダーを指定するために使用されます。 コントロール間のリンクは、閉じたサイクルを形成する必要があります。 静的テキスト コントロールなどの一部のコントロールは、サイクル外に残すことができます。 この場合、このフィールドは空白のままにすることができます。
アクセシビリティ のも参照してください。
-
ヘルプ
-
[ヘルプ] ボタンで使用される、ローカライズ可能なオプションのテキスト文字列。 文字列は、区切り文字 (|) によって 2 つの部分に分割されます。 文字列の最初の部分は、ツールヒント テキストとして使用されます。 このテキストは、画像を含むコントロールのスクリーン リーダーによって使用されます。 文字列の 2 番目の部分は、将来使用するために予約されています。 区切り文字は、2 種類のテキストのいずれかが存在する場合でも必要です。
備考
x、y、幅、および高さの整数値は、ダイアログユニットではなく、インストーラーユニットにあります。 インストーラー ユニットは、10 ポイントの MS Sans Serif フォント サイズの高さの 12 分の 1 に相当します。 コントロールの座標はビルボードを基準にしています。
検証