モジュール java.desktop

パッケージ 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に適しています。 1.4では、すべてのJavaBeansの長期ストレージのサポートがjava.beansパッケージに追加されました。 XMLEncoderを参照してください。

導入されたバージョン:

1.2

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
protected String	actionCommand	ボタンによってトリガーされるアクション・コマンド文字列です。
static final int	ARMED	ビット・マスク内の「作動準備完了」ビットを識別します。このビットは、ボタンが作動準備状態またはトリガー準備状態であることを示します。
protected ChangeEvent	changeEvent	ChangeEventが示す唯一の状態(読取り専用)はソース・プロパティであるため、ボタン・モデルの各インスタンスに必要なのはこのイベント1つだけです。
static final int	ENABLED	ビット・マスク内の「有効」ビットを識別します。このビットは、マウス・ポインタなどの入力デバイスでボタンを選択できることを示します。
protected ButtonGroup	group	ボタンが属するボタン・グループです。
protected EventListenerList	listenerList	このモデル上のリスナーを格納します。
protected int	mnemonic	ボタンのニーモニックです。
static final int	PRESSED	ビット・マスク内の「押下」ビットを識別します。このビットは、ボタンが押されていることを示します。
static final int	ROLLOVER	ビット・マスク内の「ロールオーバー」ビットを識別します。このビットは、マウスがボタンの上にあることを示します。
static final 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の一部として送られるアクション・コマンド文字列を設定します。

定義:

setActionCommand、インタフェースButtonModel

パラメータ:

actionCommand - 生成したイベントを識別するString

関連項目:

• ButtonModel.getActionCommand()
• ActionEvent.getActionCommand()

getActionCommand

public String getActionCommand()

ボタンのアクション・コマンド文字列を返します。

定義:

getActionCommand、インタフェースButtonModel

戻り値:

生成したイベントを識別するString

関連項目:

• ButtonModel.setActionCommand(java.lang.String)

isArmed

public boolean isArmed()

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

定義:

isArmed、インタフェースButtonModel

戻り値:

ボタンが作動準備状態で、トリガーされる準備ができている場合はtrue

関連項目:

• ButtonModel.setArmed(boolean)

isSelected

public boolean isSelected()

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

定義:

isSelected、インタフェースButtonModel

戻り値:

ボタンが選択されている場合はtrue

isEnabled

public boolean isEnabled()

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

定義:

isEnabled、インタフェースButtonModel

戻り値:

ボタンが有効な場合はtrue

isPressed

public boolean isPressed()

ボタンが押されているかどうかを示します。

定義:

isPressed、インタフェースButtonModel

戻り値:

ボタンが押されている場合はtrue

isRollover

public boolean isRollover()

マウス・ポインタがボタンの上にあるかどうかを示します。

定義:

isRollover、インタフェースButtonModel

戻り値:

マウス・ポインタがボタンの上にある場合はtrue

setArmed

public void setArmed(boolean b)

ボタンを作動準備状態または作動準備が解除された状態としてマークします。

定義:

setArmed、インタフェースButtonModel

パラメータ:

b - ボタンを作動準備状態にするかどうか

setEnabled

public void setEnabled(boolean b)

ボタンを有効または無効にします。

定義:

setEnabled、インタフェースButtonModel

パラメータ:

b - ボタンを有効にするかどうか

関連項目:

• ButtonModel.isEnabled()

setSelected

public void setSelected(boolean b)

ボタンを選択または選択解除します。

定義:

setSelected、インタフェースButtonModel

パラメータ:

b - ボタンを選択する場合はtrue、選択を解除する場合はfalse

setPressed

public void setPressed(boolean b)

ボタンを押された状態または押されていない状態に設定します。

定義:

setPressed、インタフェースButtonModel

パラメータ:

b - ボタンを押された状態にするかどうか

関連項目:

• ButtonModel.isPressed()

setRollover

public void setRollover(boolean b)

ボタンのロールオーバー状態を設定またはクリアします。

定義:

setRollover、インタフェースButtonModel

パラメータ:

b - ボタンがロールオーバー状態かどうか

関連項目:

• ButtonModel.isRollover()

setMnemonic

public void setMnemonic(int key)

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

定義:

setMnemonic、インタフェースButtonModel

パラメータ:

key - アクセラレータ・キーを指定する整数値

getMnemonic

public int getMnemonic()

ボタンのキーボード・ニーモニックを返します。

定義:

getMnemonic、インタフェースButtonModel

戻り値:

アクセラレータ・キーを指定する整数値

関連項目:

• ButtonModel.setMnemonic(int)

addChangeListener

public void addChangeListener(ChangeListener l)

モデルにChangeListenerを追加します。

定義:

addChangeListener、インタフェースButtonModel

パラメータ:

l - 追加するリスナー

removeChangeListener

public void removeChangeListener(ChangeListener l)

モデルからChangeListenerを削除します。

定義:

removeChangeListener、インタフェースButtonModel

パラメータ:

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を追加します。

定義:

addActionListener、インタフェースButtonModel

パラメータ:

l - 追加するリスナー

removeActionListener

public void removeActionListener(ActionListener l)

モデルからActionListenerを削除します。

定義:

removeActionListener、インタフェースButtonModel

パラメータ:

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を追加します。

定義:

addItemListener、インタフェースButtonModel

定義:

addItemListener、インタフェースItemSelectable

パラメータ:

l - 追加するリスナー

関連項目:

• ItemEvent

removeItemListener

public void removeItemListener(ItemListener l)

モデルからItemListenerを削除します。

定義:

removeItemListener、インタフェースButtonModel

定義:

removeItemListener、インタフェースItemSelectable

パラメータ:

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));

このようなリスナーがない場合は空の配列を返します。

型パラメータ:

T - リクエストされたリスナーの型

パラメータ:

listenerType - 要求されるリスナーの型。java.util.EventListenerの子孫のインタフェースを指定してください

戻り値:

このモデルにFooListenerとして登録されているすべてのオブジェクトの配列。またはこのようなリスナーが登録されていない場合は空の配列

例外:

ClassCastException - listenerTypeで、java.util.EventListenerを実装するクラスまたはインタフェースが指定されなかった場合

導入されたバージョン:

1.3

関連項目:

• getActionListeners()
• getChangeListeners()
• getItemListeners()

getSelectedObjects

public Object[] getSelectedObjects()

オーバーライドしてnullを返します。

定義:

getSelectedObjects、インタフェースItemSelectable

戻り値:

選択したオブジェクトのリスト、またはnull

setGroup

public void setGroup(ButtonGroup group)

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

定義:

setGroup、インタフェースButtonModel

パラメータ:

group - ボタンが属するButtonGroup

getGroup

public ButtonGroup getGroup()

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

定義:

インタフェースButtonModel内のgetGroup

戻り値:

ボタンが属するButtonGroup

導入されたバージョン:

1.3