[ 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
author: YOSHIDA Kazuhiro
[ top ] [ prev ] [ up ] [ next ]