JavaTM Platform
Standard Ed. 6

javax.swing
クラス DefaultButtonModel

java.lang.Object
  上位を拡張 javax.swing.DefaultButtonModel
すべての実装されたインタフェース:
ItemSelectable, Serializable, ButtonModel
直系の既知のサブクラス:
JToggleButton.ToggleButtonModel

public class DefaultButtonModel
extends Object
implements ButtonModel, Serializable

Button コンポーネントのデータモデルのデフォルト実装です。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。JDK Version 1.4 以降、すべての JavaBeans の長期間の運用サポートは、java.beans パッケージに追加されています。詳細は、XMLEncoder を参照してください。


フィールドの概要
protected  String actionCommand
          ボタンによってトリガーされるアクションコマンド文字列です。
static int ARMED
          ビットマスク内の「作動準備完了」ビットを識別します。
protected  ChangeEvent changeEvent
          ChangeEvent の唯一の状態はソースプロパティーなので、ボタンモデルの各インスタンスに必要なこのイベントは 1 つだけです。
static int ENABLED
          ビットマスク内の「有効」ビットを識別します。
protected  ButtonGroup group
          ボタンが属するボタングループです。
protected  EventListenerList listenerList
          このモデル上のリスナーを格納します。
protected  int mnemonic
          ボタンのニーモニックです。
static int PRESSED
          ビットマスク内の「押下」ビットを識別します。
static int ROLLOVER
          ビットマスク内の「ロールオーバー」ビットを識別します。
static int SELECTED
          ビットマスク内の「選択」ビットを識別します。
protected  int stateMask
          ボタンの状態を格納するビットマスクです。
 
コンストラクタの概要
DefaultButtonModel()
          DefaultButtonModel を構築します。
 
メソッドの概要
 void addActionListener(ActionListener l)
          モデルに ActionListener を追加します。
 void addChangeListener(ChangeListener l)
          モデルに ChangeListener を追加します。
 void addItemListener(ItemListener l)
          モデルに ItemListener を追加します。
protected  void fireActionPerformed(ActionEvent e)
          このイベント型の通知を登録したすべてのリスナーに通知を行います。
protected  void fireItemStateChanged(ItemEvent e)
          このイベント型の通知を登録したすべてのリスナーに通知を行います。
protected  void fireStateChanged()
          このイベント型の通知を登録したすべてのリスナーに通知を行います。
 String getActionCommand()
          ボタンのアクションコマンド文字列を返します。
 ActionListener[] getActionListeners()
          この DefaultButtonModel に登録された、すべてのアクションリスナーからなる配列を返します。
 ChangeListener[] getChangeListeners()
          この DefaultButtonModel に登録された、すべての変更リスナーからなる配列を返します。
 ButtonGroup getGroup()
          ボタンが属するグループを返します。
 ItemListener[] getItemListeners()
          この DefaultButtonModel に登録された、すべての項目リスナーからなる配列を返します。
<T extends EventListener>
T[]
getListeners(Class<T> listenerType)
          このモデルに FooListener として現在登録されているすべてのオブジェクトの配列を返します。
 int getMnemonic()
          ボタンのキーボードニーモニックを返します。
 Object[] getSelectedObjects()
          オーバーライドして null を返します。
 boolean isArmed()
          ボタンが作動準備状態であることを示します。
 boolean isEnabled()
          マウスポインタなどの入力デバイスで、ボタンを選択したり、トリガーしたりできるかどうかを示します。
 boolean isPressed()
          ボタンが押されているかどうかを示します。
 boolean isRollover()
          マウスポインタがボタンの上にあるかどうかを示します。
 boolean isSelected()
          ボタンが選択されているかどうかを示します。
 void removeActionListener(ActionListener l)
          モデルから ActionListener を削除します。
 void removeChangeListener(ChangeListener l)
          モデルから ChangeListener を削除します。
 void removeItemListener(ItemListener l)
          モデルから ItemListener を削除します。
 void setActionCommand(String actionCommand)
          ボタンがトリガーされたときに ActionEvent の一部として送られるアクションコマンド文字列を設定します。
 void setArmed(boolean b)
          ボタンを作動準備状態または作動準備が解除された状態としてマークします。
 void setEnabled(boolean b)
          ボタンを有効または無効にします。
 void setGroup(ButtonGroup group)
          ボタンが属するグループを識別します。
 void setMnemonic(int key)
          ボタンのキーボードニーモニック (ショートカットキーまたはアクセラレータキー) を設定します。
 void setPressed(boolean b)
          ボタンを押された状態または押されていない状態に設定します。
 void setRollover(boolean b)
          ボタンのロールオーバー状態を設定または解除します。
 void setSelected(boolean b)
          ボタンを選択または選択解除します。
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

stateMask

protected int stateMask
ボタンの状態を格納するビットマスクです。


actionCommand

protected String actionCommand
ボタンによってトリガーされるアクションコマンド文字列です。


group

protected ButtonGroup group
ボタンが属するボタングループです。


mnemonic

protected int mnemonic
ボタンのニーモニックです。


changeEvent

protected transient ChangeEvent changeEvent
ChangeEvent の唯一の状態はソースプロパティーなので、ボタンモデルの各インスタンスに必要なこのイベントは 1 つだけです。生成されるイベントのソースは、常に this です。


listenerList

protected EventListenerList listenerList
このモデル上のリスナーを格納します。


ARMED

public static final int ARMED
ビットマスク内の「作動準備完了」ビットを識別します。このビットは、ボタンが作動準備状態またはトリガー準備状態であることを示します。

関連項目:
定数フィールド値

SELECTED

public static final int SELECTED
ビットマスク内の「選択」ビットを識別します。このビットは、ボタンが選択されていることを示します。ラジオボタンやチェックボックスなどの特定の種類のボタンにだけ必要です。

関連項目:
定数フィールド値

PRESSED

public static final int PRESSED
ビットマスク内の「押下」ビットを識別します。このビットは、ボタンが押されていることを示します。

関連項目:
定数フィールド値

ENABLED

public static final int ENABLED
ビットマスク内の「有効」ビットを識別します。このビットは、マウスポインタなどの入力デバイスでボタンを選択できることを示します。

関連項目:
定数フィールド値

ROLLOVER

public static final int ROLLOVER
ビットマスク内の「ロールオーバー」ビットを識別します。このビットは、マウスがボタンの上にあることを示します。

関連項目:
定数フィールド値
コンストラクタの詳細

DefaultButtonModel

public DefaultButtonModel()
DefaultButtonModel を構築します。

メソッドの詳細

setActionCommand

public void setActionCommand(String actionCommand)
ボタンがトリガーされたときに ActionEvent の一部として送られるアクションコマンド文字列を設定します。

定義:
インタフェース ButtonModel 内の setActionCommand
パラメータ:
actionCommand - 生成したイベントを識別する String
関連項目:
ButtonModel.getActionCommand(), ActionEvent.getActionCommand()

getActionCommand

public String getActionCommand()
ボタンのアクションコマンド文字列を返します。

定義:
インタフェース ButtonModel 内の getActionCommand
戻り値:
生成したイベントを識別する String
関連項目:
ButtonModel.setActionCommand(java.lang.String)

isArmed

public boolean isArmed()
ボタンが作動準備状態であることを示します。

定義:
インタフェース ButtonModel 内の isArmed
戻り値:
ボタンが作動準備状態で、トリガーされる準備が できている場合は true
関連項目:
ButtonModel.setArmed(boolean)

isSelected

public boolean isSelected()
ボタンが選択されているかどうかを示します。ラジオボタンやチェックボックスなどの特定の種類のボタンにだけ必要です。

定義:
インタフェース ButtonModel 内の isSelected
戻り値:
ボタンが選択されている場合は true

isEnabled

public boolean isEnabled()
マウスポインタなどの入力デバイスで、ボタンを選択したり、トリガーしたりできるかどうかを示します。

定義:
インタフェース ButtonModel 内の isEnabled
戻り値:
ボタンが有効な場合は true

isPressed

public boolean isPressed()
ボタンが押されているかどうかを示します。

定義:
インタフェース ButtonModel 内の isPressed
戻り値:
ボタンが押されている場合は true

isRollover

public boolean isRollover()
マウスポインタがボタンの上にあるかどうかを示します。

定義:
インタフェース ButtonModel 内の isRollover
戻り値:
マウスポインタがボタンの上にある場合は true

setArmed

public void setArmed(boolean b)
ボタンを作動準備状態または作動準備が解除された状態としてマークします。

定義:
インタフェース ButtonModel 内の setArmed
パラメータ:
b - ボタンを作動準備状態にするかどうか

setEnabled

public void setEnabled(boolean b)
ボタンを有効または無効にします。

定義:
インタフェース ButtonModel 内の setEnabled
パラメータ:
b - ボタンを有効にするかどうか
関連項目:
ButtonModel.isEnabled()

setSelected

public void setSelected(boolean b)
ボタンを選択または選択解除します。

定義:
インタフェース ButtonModel 内の setSelected
パラメータ:
b - ボタンを選択する場合は true、 選択を解除する場合は false

setPressed

public void setPressed(boolean b)
ボタンを押された状態または押されていない状態に設定します。

定義:
インタフェース ButtonModel 内の setPressed
パラメータ:
b - ボタンを押された状態にするかどうか
関連項目:
ButtonModel.isPressed()

setRollover

public void setRollover(boolean b)
ボタンのロールオーバー状態を設定または解除します。

定義:
インタフェース ButtonModel 内の setRollover
パラメータ:
b - ボタンがロールオーバー状態かどうか
関連項目:
ButtonModel.isRollover()

setMnemonic

public void setMnemonic(int key)
ボタンのキーボードニーモニック (ショートカットキーまたはアクセラレータキー) を設定します。

定義:
インタフェース ButtonModel 内の setMnemonic
パラメータ:
key - アクセラレータキーを指定する整数値

getMnemonic

public int getMnemonic()
ボタンのキーボードニーモニックを返します。

定義:
インタフェース ButtonModel 内の getMnemonic
戻り値:
アクセラレータキーを指定する整数値
関連項目:
ButtonModel.setMnemonic(int)

addChangeListener

public void addChangeListener(ChangeListener l)
モデルに ChangeListener を追加します。

定義:
インタフェース ButtonModel 内の addChangeListener
パラメータ:
l - 追加するリスナー

removeChangeListener

public void removeChangeListener(ChangeListener l)
モデルから ChangeListener を削除します。

定義:
インタフェース ButtonModel 内の removeChangeListener
パラメータ:
l - 削除するリスナー

getChangeListeners

public ChangeListener[] getChangeListeners()
この DefaultButtonModel に登録された、すべての変更リスナーからなる配列を返します。

戻り値:
このモデルの changeListener 全部。 変更リスナーが現在登録されていない場合は 空の配列
導入されたバージョン:
1.4
関連項目:
addChangeListener(javax.swing.event.ChangeListener), removeChangeListener(javax.swing.event.ChangeListener)

fireStateChanged

protected void fireStateChanged()
このイベント型の通知を登録したすべてのリスナーに通知を行います。イベントのインスタンスはあとで生成されます。

関連項目:
EventListenerList

addActionListener

public void addActionListener(ActionListener l)
モデルに ActionListener を追加します。

定義:
インタフェース ButtonModel 内の addActionListener
パラメータ:
l - 追加するリスナー

removeActionListener

public void removeActionListener(ActionListener l)
モデルから ActionListener を削除します。

定義:
インタフェース ButtonModel 内の removeActionListener
パラメータ:
l - 削除するリスナー

getActionListeners

public ActionListener[] getActionListeners()
この DefaultButtonModel に登録された、すべてのアクションリスナーからなる配列を返します。

戻り値:
このモデルのすべての ActionListener。 アクションリスナーが現在登録されていない場合は 空の配列
導入されたバージョン:
1.4
関連項目:
addActionListener(java.awt.event.ActionListener), removeActionListener(java.awt.event.ActionListener)

fireActionPerformed

protected void fireActionPerformed(ActionEvent e)
このイベント型の通知を登録したすべてのリスナーに通知を行います。

パラメータ:
e - リスナーに配信される ActionEvent
関連項目:
EventListenerList

addItemListener

public void addItemListener(ItemListener l)
モデルに ItemListener を追加します。

定義:
インタフェース ItemSelectable 内の addItemListener
定義:
インタフェース ButtonModel 内の addItemListener
パラメータ:
l - 追加するリスナー
関連項目:
ItemEvent

removeItemListener

public void removeItemListener(ItemListener l)
モデルから ItemListener を削除します。

定義:
インタフェース ItemSelectable 内の removeItemListener
定義:
インタフェース ButtonModel 内の removeItemListener
パラメータ:
l - 削除するリスナー
関連項目:
ItemEvent

getItemListeners

public ItemListener[] getItemListeners()
この DefaultButtonModel に登録された、すべての項目リスナーからなる配列を返します。

戻り値:
このモデルのすべての ItemListener。 項目リスナーが現在登録されていない場合は 空の配列
導入されたバージョン:
1.4
関連項目:
addItemListener(java.awt.event.ItemListener), removeItemListener(java.awt.event.ItemListener)

fireItemStateChanged

protected void fireItemStateChanged(ItemEvent e)
このイベント型の通知を登録したすべてのリスナーに通知を行います。

パラメータ:
e - リスナーに配信される ItemEvent
関連項目:
EventListenerList

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)
このモデルに FooListener として現在登録されているすべてのオブジェクトの配列を返します。FooListener は、addFooListener メソッドを使用して登録します。

FooListener.class といったクラスリテラルを使用して、listenerType 引数を指定できます。たとえば、このアクションリスナーに対する DefaultButtonModel インスタンス m の照会は次のコードで行います。

ActionListener[] als = (ActionListener[])(m.getListeners(ActionListener.class));
このようなリスナーがない場合は空の配列を返します。

パラメータ:
listenerType - 要求されたリスナーのタイプ。 このパラメータは java.util.EventListener の下位インタフェースを指定する
戻り値:
FooListener として登録されている このモデル上の すべてのオブジェクトの配列。 そのようなリスナーが追加されていない場合は 空の配列
例外:
ClassCastException - listenerTypejava.util.EventListener を実装するクラスまたはインタフェースを 指定しない場合
導入されたバージョン:
1.3
関連項目:
getActionListeners(), getChangeListeners(), getItemListeners()

getSelectedObjects

public Object[] getSelectedObjects()
オーバーライドして null を返します。

定義:
インタフェース ItemSelectable 内の getSelectedObjects

setGroup

public void setGroup(ButtonGroup group)
ボタンが属するグループを識別します。これは、グループ内で排他的な選択をするラジオボタンに必要です。

定義:
インタフェース ButtonModel 内の setGroup
パラメータ:
group - ボタンが属する ButtonGroup

getGroup

public ButtonGroup getGroup()
ボタンが属するグループを返します。通常、グループ内で排他的に選択されるラジオボタンで使用されます。

戻り値:
ボタンが属する ButtonGroup
導入されたバージョン:
1.3

JavaTM Platform
Standard Ed. 6

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

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。