JavaTM 2
Platform
Std. Ed. v1.4.0

javax.swing
クラス ButtonGroup

java.lang.Object
  |
  +--javax.swing.ButtonGroup
すべての実装インタフェース:
Serializable

public class ButtonGroup
extends Object
implements Serializable

複数のボタンのセットに多重排他スコープを設定するために使用します。同じ ButtonGroup オブジェクトを使用してボタンのセットを作成した場合、1 つのボタンをオンにすると、グループに含まれるほかのボタンがすべてオフになります。

ButtonGroup は、AbstractButton から継承するオブジェクトセットで使用できます。通常、ボタングループは JRadioButtonJRadioButtonMenuItem、または JToggleButton のインスタンスを含みます。ボタングループに JButton または JMenuItem のインスタンスを含むのは、JButton および JMenuItem が選択状態を実装しないため、あまり意味がありません。

初期状態では、グループのボタンは 1 つも選択されていません。一度どれかが選択されると、そのグループでは 1 つのボタンが常に選択されています。ボタンをプログラム処理でオフにし、ボタングループを初期化する方法はありません。1 つも選択されていない状態を実現するには、非表示のラジオボタンをグループに追加して、表示されているすべてのラジオボタンをこの非表示のボタンでオフにできるようプログラム的に選択します。たとえば、「none」というラベルの付いた通常のボタンに、この非表示ラジオボタンを選択する機能を持たせることができます。

ボタングループの使用例および詳細については、「The Java Tutorial」の 「How to Use Radio Buttons」を参照してください。

警告: このクラスの直列化オブジェクトは今後リリースされる Swing との互換性はありません。現在サポートされている直列化は、短期間の保管、または同じバージョンの Swing が稼働しているアプリケーション間の RMI に適しています。1.4 からは、すべての JavaBeansTM の長期間の保管が java.beans パッケージで追加サポートされています。XMLEncoder を参照してください。


フィールドの概要
protected  Vector buttons
           
 
コンストラクタの概要
ButtonGroup()
          新しい ButtonGroup を生成します。
 
メソッドの概要
 void add(AbstractButton b)
          グループにボタンを追加します。
 int getButtonCount()
          グループ内のボタンの数を返します。
 Enumeration getElements()
          グループに関連するすべてのボタンを返します。
 ButtonModel getSelection()
          選択されたボタンのモデルを返します。
 boolean isSelected(ButtonModel m)
          ButtonModel が選択されているかどうかを返します。
 void remove(AbstractButton b)
          グループからボタンを削除します。
 void setSelected(ButtonModel m, boolean b)
          ButtonModel に対して選択された値を設定します。
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

buttons

protected Vector buttons
コンストラクタの詳細

ButtonGroup

public ButtonGroup()
新しい ButtonGroup を生成します。

メソッドの詳細

add

public void add(AbstractButton b)
グループにボタンを追加します。

パラメータ:
b - 追加するボタン

remove

public void remove(AbstractButton b)
グループからボタンを削除します。

パラメータ:
b - 削除するボタン

getElements

public Enumeration getElements()
グループに関連するすべてのボタンを返します。

戻り値:
このグループのボタンの Enumeration

getSelection

public ButtonModel getSelection()
選択されたボタンのモデルを返します。

戻り値:
選択されたボタンのモデル

setSelected

public void setSelected(ButtonModel m,
                        boolean b)
ButtonModel に対して選択された値を設定します。一度に選択できるボタンはグループで 1 つだけです。


isSelected

public boolean isSelected(ButtonModel m)
ButtonModel が選択されているかどうかを返します。

戻り値:
ボタンが選択されている場合は true、そうでない場合は false

getButtonCount

public int getButtonCount()
グループ内のボタンの数を返します。

戻り値:
ボタンの数

JavaTM 2
Platform
Std. Ed. v1.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.