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 として登録されているすべてのオブジェクトの配列。 このモデル上の FooListener。 そのようなリスナーが追加されていない場合は 空の配列

例外:

ClassCastException - listenerType が java.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