RadioButtonGroup コントロール
RadioButtonGroup コントロールは、ラジオ ボタンのグループです。 これにより、ユーザーは、事前に定義された値の一覧からプロパティの文字列または整数値を選択できます。 このコントロールをプロパティに関連付けるには、Control テーブルの [プロパティ] 列にプロパティの名前入力します。 RadioButton テーブルの [値] 列で、選択できる値を指定します。 表示される文字列は、ユーザーが選択する値と必ずしも同じではないことに注意してください。
すべての RadioButtonGroup コントロールは、プロパティに関連付けられます。 このプロパティの既定値は、Property テーブルで初期化する必要があります。 RadioButton テーブルで指定された各 RadioButtonGroup 内には、このプロパティの既定値と一致する値が [値] フィールドに 1 つのラジオ ボタンが存在する場合があります。 これは RadioButtonGroup コントロールの既定のボタンです。 既定の ボタンは、最初はコントロールで選択されているように表示されます。
ダイアログ ボックスのフォーカスは、グループ内のいずれかのボタンが選択されるまで RadioButtonGroup コントロールに移動できないことに注意してください。 フォーカスをこのボタン グループに移動するには、いずれかのボタンをグループの既定のボタンとして指定します。
RadioButtonGroup コントロールはプロパティ値のみを設定し、ControlEventを送信するために使用することはできません。
実装ではグループ全体が 1 つのコントロールとして扱われるため、グループ内の個々のボタンを非表示または無効にすることはできません。 同様に、すべてのボタンは同じスタイルである必要があります。つまり、すべてのボタンにテキストがあるか、またはすべてのボタンにビットマップ (またはその他の同様の機能) があります。 ボタンの位置は、グループを基準として作成されます。 これにより、個々のボタンを変更せずにグループの座標のみを変更することで、グループ全体を移動できます。 コントロールの作成時に、個々のボタンがグループの境界を越えて拡張されていないことを確認します。
コントロール属性
このコントロールでは、次の属性を使用できます。 イベントを使用して属性の値を変更するには、EventMapping テーブルの ControlEvent コントロールをサブスクライブし、[属性] 列に属性の識別子を一覧表示します。 [イベント] 列に ControlEvent の識別子を入力します。
| 属性識別子 | 16 進数ビット | 形容 |
|---|---|---|
| IndirectPropertyName | これは、コントロールに関連付けられている間接プロパティの名前です。 間接属性ビットが設定されている場合、コントロールは、この名前を持つプロパティの値を表示または変更します。 間接属性ビットが設定されている場合、この名前は、Control テーブルの [プロパティ] 列に表示されるプロパティの値。 | |
| 位置 | ダイアログ ボックス内のコントロールの位置。 コントロールの左隅のコントロールの幅、高さ、および座標を、Control テーブルの [幅]、[高さ]、[X]、および [Y] 列に入力。 長さと距離 インストーラー ユニットを使用します。 |
|
| PropertyName | これは、このコントロールに関連付けられているプロパティの名前です。 Indirect 属性ビットが設定されていない場合、コントロールは、この名前を持つプロパティの値を表示または変更します。 この属性は、コントロール テーブルの [プロパティ] 列で指定します。 | |
| PropertyValue | このコントロールによって表示または変更されたプロパティの現在の値。 間接属性ビットが設定されていない場合、これは PropertyName の値です。 Indirect 属性ビットが設定されている場合、これは IndirectPropertyName の値です。 属性が変更されると、コントロールには新しい値が反映されます。 | |
| テキスト | このコントロール属性は、コントロールによって表示されるテキスト、バイナリ テーブルに格納されているイメージ、または実行時に設定されたイメージを指定できます。 テキストを指定するには、コントロール テーブルの [テキスト] 列にテキスト文字列入力します。 このテキストのフォントとフォント スタイルを設定するには、表示される文字の文字列の先頭に {\style} または {&スタイル} を付けます。 ここで、style は、TextStyle テーブルの TextStyle 列に一覧表示される識別子です。 どちらも存在しないが、DefaultUIFont プロパティが有効なテキスト スタイルとして定義されている場合は、そのフォントが使用されます。 バイナリ テーブルに格納されているアイコンまたはビットマップ イメージを指定するには バイナリ テーブルの [名前] 列からコントロールの コントロール テーブル レコードの Text 列に画像のレコードの主キーを入力します。 |
|
| 表示 | 0x00000000 0x00000001 |
非表示のコントロール。 表示コントロール。 コントロールを作成時に表示または非表示にするには、コントロール テーブルの の [属性] 列のビット ワードにこのビットを含めます。 ControlCondition テーブルを使用して、コントロールを非表示または表示することもできます。 |
| Enabled | 0x00000000 0x00000002 |
無効な状態のコントロール。 有効な状態での制御。 作成時にコントロールを有効にするには、コントロール の [属性] 列にこのビットを含めます。 ControlCondition テーブルを使用して、コントロールを有効または無効にすることもできます。 |
| 沈没 | 0x00000000 0x00000004 |
既定の表示スタイルを表示します。 コントロールを 3-D の見た目で表示します。 これらのビットは、コントロール テーブルの [属性] 列のビット ワード含めます。 |
| 間接 の | 0x00000000 0x00000008 |
コントロールは、コントロール テーブルの Property 列にプロパティの値を表示または変更します。 コントロールは、コントロール テーブルの Property 列に表示される識別子を持つプロパティの値を表示または変更します。 このコントロールに関連付けられているプロパティが間接的に参照されているかどうかを判断します。 |
| 整数 の | 0x00000000 0x00000010 |
コントロールに関連付けられているプロパティは文字列値です。 コントロールに関連付けられているプロパティは整数値です。 コントロールの作成時にこの属性を設定するには、コントロール テーブルの の Attributes 列のビット ワードにこのビットを含めます。 |
| RTLRO を する | 0x00000000 0x00000020 |
コントロール内のテキストは、左から右の読み取り順序で表示されます。 コントロール内のテキストは、右から左の読み取り順序で表示されます。 |
| RightAligned を する | 0x00000000 0x00000040 |
コントロール内のテキストは左に配置されます。 コントロール内のテキストが右側に配置されます。 |
| PushLike | 0x00000000 0x00020000 |
コントロールは通常の外観で描画されます。 コントロールにはBS_PUSHLIKEスタイルがあり、プッシュ ボタンとして表示されるように描画されます。 コントロールの作成時にこの属性を設定するには、コントロール テーブルの の Attributes 列のビット ワードにこのビットを含めます。 |
| ビットマップ の | 0x00000000 0x00040000 |
コントロール内のテキストは、コントロール テーブルの [テキスト] 列指定します。 コントロールにはBS_BITMAPスタイルがあり、コントロール内のテキストはビットマップイメージに置き換えられます。
コントロール テーブル の Text 列は、バイナリ テーブルの外部キーとして使用されます。 このビットは、コントロール テーブルの [属性] 列のビット ワード含めます。 アイコンとビットマップスタイルのビットを同時に設定しないでください。 ボタンにビットマップイメージとテキストの両方を含めることはできません。 テキスト文字列のフォントとフォント スタイルを設定するには、表示される文字の文字列の先頭に {\style} または {&スタイル} を付けます。 ここで、style は、TextStyle テーブルの TextStyle 列に一覧表示される識別子です。 どちらも存在しないが、DefaultUIFont プロパティが有効なテキスト スタイルとして定義されている場合は、そのフォントが使用されます。 |
| アイコンの | 0x00000000 0x00080000 |
コントロール内のテキストは、コントロール テーブルの [テキスト] 列指定します。 コントロールにはBS_ICONスタイルがあり、コントロール内のテキストはアイコンイメージに置き換えられます。
コントロール テーブル の Text 列は、バイナリ テーブルの外部キーとして使用されます。 このビットは、コントロール テーブルの [属性] 列のビット ワード含めます。 アイコンビットとビットマップビットを同時に設定しないでください。 ボタンにアイコン画像とテキストの両方を含めることはできません。 テキスト文字列のフォントとフォント スタイルを設定するには、表示される文字の文字列の先頭に {\style} または {&スタイル} を付けます。 ここで、style は、TextStyle テーブルの TextStyle 列に一覧表示される識別子です。 どちらも存在しないが、DefaultUIFont プロパティが有効なテキスト スタイルとして定義されている場合は、そのフォントが使用されます。 |
| FixedSize | 0x00000000 0x00100000 |
コントロールに合わせてアイコンイメージを拡大します。 コントロール内のアイコンイメージをトリミングまたは中央揃えします。 このビットは、コントロール テーブルの [属性] 列のビット ワード含めます。 |
| IconSize | 0x00000000 0x00200000 0x00400000 0x00600000 |
最初のイメージを読み込みます。 最初の 16 x 16 イメージを読み込みます。 最初の 32 x 32 イメージを読み込みます。 最初の 48 x 48 イメージを読み込みます。 アイコン ファイルには、同じアイコンの異なるサイズの画像を含めることができます。 コントロール テーブルの [属性] 列に適切なビット ワードの値を含めます これらのビットが設定されていない場合、インストーラーは FixedSize 属性を無視し、コントロールの四角形に合わせてイメージが拡大されます。 IconSize ビットと FixedSize ビットの両方が設定されている場合、コントロールよりも小さいイメージが中央に配置され、イメージが縮小されて収まるコントロールよりも大きくなります。 |
| HasBorder を する | 0x01000000設定されていません |
罫線なし、テキストなし。 罫線とテキストを表示します。 コントロール の [属性] 列のビット ワードに16777216を含め、罫線とテキストを表示します。 |
備考
Windows がフレームを描画する方法により、キャプションがない場合でも、コントロールのウィンドウの上部と表示されるフレームの間にギャップがあります。
このコントロールは、CreateWindowEx 関数を使用して BUTTON クラスから作成できます。 HasBorder ビットが設定されている場合は、BS_GROUPBOX スタイルが設定され、それ以外の場合は BS_OWNERDRAW スタイルになります。
RadioButtonGroup コントロールは他のコントロールと重ならないようにし、他のコントロールは RadioButtonGroup と重ならないようにする必要があります。 このコントロールと別のコントロールが重複すると、コントロールが正しく機能または表示されない可能性があります。 RadioButtonGroup コントロールに関する追加の説明テキストをスクリーン リーダー プログラムに提供するには、「Radio Buttonsにテキストを追加する」の例に従います。