JavaTM 2
Platform
Std. Ed. v1.4.0

javax.swing
クラス DefaultButtonModel

java.lang.Object
  |
  +--javax.swing.DefaultButtonModel
すべての実装インタフェース:
ButtonModel, ItemSelectable, Serializable
直系の既知のサブクラス:
JToggleButton.ToggleButtonModel

public class DefaultButtonModel
extends Object
implements ButtonModel, Serializable

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

警告: このクラスの直列化オブジェクトは今後リリースされる Swing との互換性はありません。現在サポートされている直列化は、短期間の保管、または同じバージョンの Swing が稼働しているアプリケーション間の RMI に適しています。1.4 からは、すべての JavaBeansTM の長期間の保管が 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 に登録されているすべての項目リスナーの配列を返します。
 EventListener[] getListeners(Class 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 を追加します。

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

removeItemListener

public void removeItemListener(ItemListener l)
ボタンから ItemListener を削除します。

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

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 EventListener[] getListeners(Class listenerType)
このモデルに FooListener として現在登録されているすべてのオブジェクトの配列を返します。この FooListeneraddFooListener メソッドで登録されたものです。

listenerType 引数は FooListener.class のようなクラスリテラルで指定できます。たとえば、このアクションリスナーに対する 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 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.