[ top ] [ prev ] [ up ] [ next ]
Phi::RadioGroup
- ひとつのまとまりとして機能するラジオボタンのグループ
RadioGroup オブジェクトはラジオボタンだけを格納する特殊なグループボックスです。同じコントロール内に直接配置されたラジオボタンは「グループ化された」といいます。ユーザーがラジオボタンをチェックしたときには,グループ内の他のラジオボタンがすべて選択が解除されます。したがって,2 つのラジオボタンをチェックできるのは,ラジオボタンがグループボックスなどのコンテナに別々に配置されている場合だけです。
ラジオボタンを RadioGroup に追加するには, items を編集してください。
items の各文字列はその文字列をキャプションとするラジオボタンをグループボックスに表示します。
Item_index の値は,どのラジオボタンが現在選択されているかを決めます。
columns の値を設定することで,ラジオボタンを 1 列に表示するか複数の列に表示するかを指定できます。
super class
- Phi::GroupBox
class methods
- new(parent[, name, caption]) : Phi::RadioGroup
-
- columns : Fixnum
-
ラジオグループ内の列数
columns は,ラジオグループ内の列数を指定します。指定できる値は 1..16 です。
デフォルト値は 1 で,その場合ラジオボタンは縦 1 列に並べられます。
- item_index : Fixnum
-
現在グループ内のどのラジオボタンが選択されているか
item_index は items リストの選択されているラジオボタンのインデックスを保持します(最初のボタンの番号は 0)。
item_index の値は,実行時にユーザーがラジオボタンを選択するたびに変化します。
アプリケーションの起動時にいずれかのボタンが選択されているようにするには,設計時に item_index でそのボタンを指定します。
起動時にどのボタンも選択されていないようにするには,item_index をデフォルト値の -1 にしておきます。
- items : Phi::Strings
-
ラジオグループ内のラジオボタンのキャプションリスト
items は,グループ内のラジオボタンのキャプションをリストする Phi::Strings オブジェクトを保持します。
- 注意
-
ラジオグループオブジェクト内の項目は
CustomRadioGroup
によって生成される特殊な RadioButton
のインスタンスです。別々に作成した Phi::RadioButton インスタンスは,同じラジオグループに入れることはできません。
events
OnEnter
OnExit
OnClick
OnContextPopup
OnDragDrop
OnDragOver
OnEndDock
OnEndDrag
OnStartDock
OnStartDrag
[ top ] [ prev ] [ up ] [ next ]