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 バージョン 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()
デフォルトの JButtonModel を構築します。

メソッドの概要

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) ボタンが押されたときにイベントの一部として送られる、actionCommand 文字列を設定します。
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

ボタンが選択されていることを示します。RadioButton や Checkbox などの特定の種類のボタンにだけ必要です。

関連項目:

定数フィールド値

PRESSED

public static final int PRESSED

ボタンが「押された」ことを示します。通常は、マウスボタンを離したときを示します。

関連項目:

定数フィールド値

ENABLED

public static final int ENABLED

マウスポインタなどの入力デバイスで、ボタンを選択できることを示します。

関連項目:

定数フィールド値

ROLLOVER

public static final int ROLLOVER

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

関連項目:

定数フィールド値

コンストラクタの詳細

DefaultButtonModel

public DefaultButtonModel()

デフォルトの JButtonModel を構築します。

メソッドの詳細

setActionCommand

public void setActionCommand(String actionCommand)

ボタンが押されたときにイベントの一部として送られる、actionCommand 文字列を設定します。

定義:

インタフェース ButtonModel 内の setActionCommand

パラメータ:

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

getActionCommand

public String getActionCommand()

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

定義:

インタフェース ButtonModel 内の getActionCommand

戻り値:

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

関連項目:

setActionCommand(java.lang.String)

isArmed

public boolean isArmed()

ボタンが作動準備状態であるかどうかを示します。

定義:

インタフェース ButtonModel 内の isArmed

戻り値:

ボタンが作動準備状態で、押下に備えた状態の場合は true

関連項目:

setArmed(boolean)

isSelected

public boolean isSelected()

ボタンが選択されているかどうかを示します。RadioButton や Checkbox など特定の種類のボタンにだけ必要です。

定義:

インタフェース 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 - ボタンを作動準備状態にして選択可能にする場合は true

setEnabled

public void setEnabled(boolean b)

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

定義:

インタフェース ButtonModel 内の setEnabled

パラメータ:

b - ボタンを有効にする場合は true

関連項目:

isEnabled()

setSelected

public void setSelected(boolean b)

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

定義:

インタフェース ButtonModel 内の setSelected

パラメータ:

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

setPressed

public void setPressed(boolean b)

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

定義:

インタフェース ButtonModel 内の setPressed

パラメータ:

b - ボタンを「押された状態」に設定する場合は true

関連項目:

isPressed()

setRollover

public void setRollover(boolean b)

ボタンの反転状態を設定または解除します。

定義:

インタフェース ButtonModel 内の setRollover

パラメータ:

b - 反転をオンにする場合は true

関連項目:

isRollover()

setMnemonic

public void setMnemonic(int key)

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

定義:

インタフェース ButtonModel 内の setMnemonic

パラメータ:

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

getMnemonic

public int getMnemonic()

モデルのキーボードニーモニックを返します。

定義:

インタフェース ButtonModel 内の getMnemonic

戻り値:

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

関連項目:

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 メソッドで登録されたものです。

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

ActionListener[] als = (ActionListener[])(m.getListeners(ActionListener.class));

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

パラメータ:

listenerType - 要求されるリスナーの型。java.util.EventListener の下位インタフェースを指定

戻り値:

このモデルに 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