RadioButton テーブル
ラジオ ボタンは個々のコントロールとして扱われるのではなく、RadioButtonGroup コントロールとして機能するラジオ ボタン グループの一部です。 RadioButton テーブルでは、すべてのグループのボタンが指定されています。
RadioButton テーブルには次の列があります。
Column | 種類 | キー | Nullable |
---|---|---|---|
プロパティ | Identifier | Y | N |
注文 | 整数 | Y | N |
値 | Formatted | N | N |
X | 整数 | N | N |
Y | 整数 | N | N |
幅 | 整数 | N | N |
[高さ] | 整数 | N | N |
テキスト | Formatted | N | Y |
ヘルプ | テキスト | N | Y |
[列]
-
Property
-
このラジオ ボタンに関連付けられる名前付きプロパティ。 同じプロパティに関連付けられているすべてのボタンが、同じグループの一部になります。
-
Order
-
1 つのリスト内での項目の順序を決めるために使われる正の整数。 連続した整数でなくてもかまいません。
-
Value
-
このボタンに関連付けられている値文字列。 ボタンを選ぶと、関連付けられているプロパティにこの値が設定されます。
-
X
-
ラジオ ボタンの外接四角形の左上隅の、グループ内での水平座標。 これは負ではない数である必要があります。
-
Y
-
ラジオ ボタンの外接四角形の左上隅の、グループ内での垂直座標。 これは負ではない数である必要があります。
-
Width
-
ボタンの幅。 これは負ではない数である必要があります。
-
Height
-
ボタンの高さ。 これは負ではない数である必要があります。
-
Text
-
ラジオ ボタンに割り当てるローカライズ可能な表示タイトル。 テキストが長すぎてコントロールに収まらない場合は、切り捨てられます。 ボタンにアイコンまたはビットマップを表示する場合、この列では画像の名前を指定します。これは Binary テーブルへのキーです。 ボタンに画像とテキストの両方を表示する方法はありません。
-
ヘルプ
-
ボタンで使われるヘルプ文字列。 テキストは省略可能であり、ローカライズ可能です。 この文字列は、文字 (|) で 2 つの部分に分割されます。 文字列の最初の部分は、ツールヒントのテキストとして使われます。 このテキストは、画像を含むコントロールの場合にスクリーン リーダーによって示されます。 2 番目の部分は状況依存ヘルプに使われますが、状況依存ヘルプはまだ実装されていません。 2 種類のテキストのうち 1 つだけが存在する場合でも、区切り文字が必要です。
解説
X、Y、Width、Height に対する各整数値は、ダイアログ単位ではなく、インストーラー単位です。 インストーラー単位は、10 ポイントの MS Sans Serif フォント サイズの 12 分の 1 の高さに等しくなります。 コントロールの座標はビルボードを基準としています。
ボタンの座標は、グループに対して相対的に指定します。 グループの座標が変更されても、グループ内のボタン相互の相対位置は変わりません。
Value と Text フィールドの内容は、コントロールが作成されるときに MsiFormatRecord 関数によって書式設定されるため、MsiFormatRecord 関数が解釈できる任意の式を含むことができます。 書式設定は、コントロールが作成されるときにのみ行われるため、コントロールの有効期間中に式に含まれるプロパティが変更されても更新されません。
すべての RadioButtonGroup コントロールは、プロパティに関連付けられます。 このプロパティの既定値は、Property テーブルで初期化される必要があります。 RadioButton テーブルで指定されている各 RadioButtonGroup 内には、Value フィールドの値がこのプロパティの既定値と一致するラジオ ボタンが 1 つ存在できます。 これは RadioButtonGroup コントロールの既定のボタンです。 既定のボタンは、最初から選択された状態でコントロールに表示されます。
ユーザーは、グループ内のボタンの 1 つを選ぶまで、Tab キーを押してダイアログ ボックスのフォーカスを RadioButtonGroup コントロールに変更できないことに注意してください。 Tab キーを押してフォーカスをこのボタン グループに移動できるようにするには、ボタンの 1 つをグループの既定のボタンとして指定します。
検証