title: Phi::RadioGroup
author: YOSHIDA Kazuhiro
mailto: moriq@moriq.com

1. Phi::RadioGroup

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

  RadioGroup オブジェクトはラジオボタンだけを格納する特殊なグループボックスです。同じコントロール内に直接配置されたラジオボタンは「グループ化された」といいます。ユーザーがラジオボタンをチェックしたときには，グループ内の他のラジオボタンがすべて選択が解除されます。したがって，2 つのラジオボタンをチェックできるのは，ラジオボタンがグループボックスなどのコンテナに別々に配置されている場合だけです。

  ラジオボタンを RadioGroup に追加するには， #items を編集してください。
  #items の各文字列はその文字列をキャプションとするラジオボタンをグループボックスに表示します。
  #Item_index の値は，どのラジオボタンが現在選択されているかを決めます。

  #columns の値を設定することで，ラジオボタンを 1 列に表示するか複数の列に表示するかを指定できます。

1.1. super class

  Phi::GroupBox#

1.1. 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# オブジェクトを保持します。

  : 注意
    ラジオグループオブジェクト内の項目は %c:CustomRadioGroup% によって生成される特殊な %c:RadioButton% のインスタンスです。別々に作成した Phi::RadioButton# インスタンスは，同じラジオグループに入れることはできません。

1.1. events

OnEnter
OnExit
OnClick
OnContextPopup
OnDragDrop
OnDragOver
OnEndDock
OnEndDrag
OnStartDock
OnStartDrag
