Create  Edit  Diff  Phillro Industries  Index  Search  Changes  History  Source  RSS  Note  wikifarm  Login

Phi::RadioGroup

Phi::RadioGroup?

ひとつのまとまりとして機能するラジオボタンのグループ

RadioGroup.jpg
require "phi"
form = Phi::Form.new :form, "Phi::RadioGroup sample"
radio_group = Phi::RadioGroup.new form, "radio group caption"
radio_group.items.add "button1"
radio_group.items.add "button2"
radio_group.items.add "button3"
radio_group.on_click =  proc{|sender|
  index = sender.item_index
  button_caption = sender.items[index]
  p [index, button_caption]
}
form.show
Phi.mainloop

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?

Last modified:2006/10/30 11:38:45
Keyword(s):
References:[Phi-Classes] [Phi-Constants] [image_of_controls]