[オプション ボタン] ユーザー インターフェイス ダイアログ ボックス
更新 : 2007 年 11 月
[オプション ボタン] ダイアログ ボックスは、インストール中に、相互に排他的な選択項目を最大で 4 つユーザーに示し、選択された項目の値を返すために使用します。[オプション ボタン (2 ボタン)]、[オプション ボタン (3 ボタン)]、および [オプション ボタン (4 ボタン)] という 3 種類の [オプション ボタン] ダイアログ ボックスを利用できます。オプション ボタンの数を除けば、これら 3 つのダイアログ ボックスはまったく同じもので、いずれも配置プロジェクトごとに 1 回だけ追加できます。
ダイアログ ボックスには、2 つ、3 つ、または 4 つのオプション ボタンと対応するラベル、そしてユーザーに情報を伝える追加ラベルが含まれています。ラベルのテキストは、[プロパティ] ウィンドウでのデザイン時に指定します。さらに、既定値を設定し、既定のオプション ボタンを設定するための追加プロパティが、各オプション ボタンに用意されています。
次の図は、インストール中に表示される標準的な [オプション ボタン (2 ボタン)] ダイアログ ボックスです。
[オプション ボタン (2 ボタン)] ダイアログ ボックス
[プロパティ]
[オプション ボタン] ダイアログ ボックスでは次のプロパティを利用できます。
プロパティ |
説明 |
---|---|
BannerBitmap |
見出し領域に表示するビットマップまたは JPEG イメージを指定します。上の図には、既定のビットマップが表示されています。詳細については、「BannerBitmap プロパティ」を参照してください。 |
BannerText |
見出し領域に表示するテキストを指定します。上の図では、"これは見出しのテキストです。" が該当テキストです。 |
BodyText |
オプション ボタンの上に表示するテキストを指定します。上の図では、"これは本体のテキストです。" が該当テキストです。 |
Button1Label |
1 番目のオプション ボタンの横に表示するテキストを指定します。上の図では、"1 番目のオプション ボタン" がこのプロパティです。 |
Button1Value |
1 番目のオプション ボタンの値を指定します。1 番目のオプション ボタンが選択された場合に、ButtonProperty プロパティで返される値です。 |
Button2Label |
2 番目のオプション ボタンの横に表示するテキストを指定します。上の図では、"2 番目のオプション ボタン" がこのプロパティです。 |
Button2Value |
2 番目のオプション ボタンの値を指定します。2 番目のオプション ボタンが選択された場合に、ButtonProperty プロパティで返される値です。 |
Button3Label |
3 番目のオプション ボタンの横に表示するテキストを指定します。[オプション ボタン (2 ボタン)] ダイアログ ボックスでは利用できません。 |
Button3Value |
3 番目のオプション ボタンの値を指定します。3 番目のオプション ボタンが選択された場合に、ButtonProperty プロパティで返される値です。[オプション ボタン (2 ボタン)] ダイアログ ボックスでは利用できません。 |
Button4Label |
4 番目のオプション ボタンの横に表示するテキストを指定します。[オプション ボタン (2 ボタン)] ダイアログ ボックスまたは [オプション ボタン (3 ボタン)] ダイアログ ボックスでは利用できません。 |
Button4Value |
4 番目のオプション ボタンの値を指定します。4 番目のオプション ボタンが選択された場合に、ButtonProperty プロパティで返される値です。[オプション ボタン (2 ボタン)] ダイアログ ボックスまたは [オプション ボタン (3 ボタン)] ダイアログ ボックスでは利用できません。 |
ButtonProperty |
選択されたオプション ボタンの値を取得するために使用するプロパティ名を指定します。このプロパティは条件内で使用できます。詳細については、「条件付き配置」を参照してください。 |
DefaultValue |
ダイアログ ボックスの表示時に最初に選択されているオプション ボタンを指定します。 |
[オプション ボタン] ダイアログ ボックスの外観の制御
以下のプロパティを使用して、インストール中の [オプション ボタン] ダイアログ ボックスの表示方法を制御します。
BannerBitmap プロパティは、ダイアログ ボックスの右上隅に表示されるイメージを制御します。イメージの位置とサイズは固定です。
ヒント :
ユーザー インターフェイスに一貫性を持たせるには、インストーラの全ダイアログ ボックスで同じイメージを使用します。
BannerText プロパティは、ダイアログ ボックス上部の見出しに表示されるテキストを制御します。位置、サイズ、およびフォント サイズは固定です。テキストは自動改行されますが、3 行以上になることはありません。
BodyText プロパティは、ダイアログ ボックスの見出しの直下に表示されるテキストを制御します。位置、サイズ、およびフォント サイズは固定です。テキストは自動改行されますが、5 行以上になることはありません。
ButtonNLabel プロパティは、オプション ボタンのラベルのテキストを制御します。位置およびフォント サイズは固定で、テキストは折り返されません。
ヒント :
ダイアログ ボックスがローカライズされる可能性がある場合、テキストの拡張用にスペースを余分に確保しておきます。ある言語から別の言語に翻訳したときにテキストが長くなってしまい、収まりきらないテキスト部分が切り取られてしまう場合があります。
[オプション ボタン] ダイアログ ボックスのプロパティを使ったユーザー選択の取得
[オプション ボタン] ダイアログ ボックスを含むインストーラが実行されると、ユーザーはオプションを選択できます。インストーラでは、その選択結果を使用して、他のインストール フェーズを制御できます。
たとえば、[オプション ボタン (2 ボタン)] ダイアログ ボックスを作成し、オプション ファイルのインストールをユーザーが選択できるようにします。この場合、Button1Label プロパティには "オプション ファイルをインストールする。" を設定し、Button2Label プロパティには "オプション ファイルをインストールしない。" を設定します。Button1Value プロパティと Button2Value プロパティは、それぞれ既定値の 1 と 2 のままにしておきます。
ユーザーが通常はオプション ファイルをインストールしないと考えられる場合は、DefaultValue プロパティに 2 を設定し、既定で選択されているようにします。
ファイル システム エディタでは、オプション ファイルに対する Condition プロパティに、既定値として、ButtonProperty プロパティの値 (BUTTON2) と Button1Value プロパティの値 (1) を組み合わせた値 (BUTTON2=1) を設定します。
インストール中には、ファイルの Condition プロパティが評価されます。ユーザーが 1 番目のオプション ボタンを選択した場合、ButtonProperty プロパティからは Button1Value が返り、ファイルがインストールされます。それ以外の場合は、条件は false と評価されて、ファイルはインストールされません。