JavaTM 2 Platform
Std. Ed. v1.3

javax.swing
インタフェース ButtonModel

すべてのスーパーインタフェース:
ItemSelectable
既知の実装クラスの一覧:
DefaultButtonModel

public interface ButtonModel
extends ItemSelectable

ボタンの状態モデルです。このモデルは、チェックボックスやラジオボタンなどの特殊なボタンにも、通常のボタンの場合と同様に使います。チェックボックスおよびラジオボタンでは、マウスボタンを押すとボタンが選択されます。通常のボタンでは、マウスボタンを押すとボタンがトリガー準備状態になります。次にマウスボタンを離したときにボタンが押された (クリックされた) ことになり、ボタンのアクションイベントがトリガーされます。別の場所でマウスボタンを離した場合は、ボタンのトリガー準備状態が解除されます。

実際の使用では、チェックボックスまたはラジオボタン上でクリックが発生したときに、UI が setSelected(boolean) を呼び出します。通常のボタンの上でマウスボタンが押されたときには setArmed(boolean) が呼び出され、マウスボタンが離されたときに setPressed(boolean) が呼び出されます。マウスボタンが押されスあとにマウスがボタンの外へ移動した場合は、setArmed(false) の通知によって、setPressed が発生してもボタンがトリガーされなくなります。マウスボタンが離される前にマウスがボタンの中に戻れば、ボタンは再びトリガー準備状態になります。

注:
ボタンは、トリガー準備状態 (armed)、および押された状態 (pressed) の両方が満たされたときにトリガーされます。


メソッドの概要
 void addActionListener(ActionListener l)
          ボタンに ActionListener を追加します。
 void addChangeListener(ChangeListener l)
          ボタンに ChangeListener を追加します。
 void addItemListener(ItemListener l)
          ボタンに ItemListener を追加します。
 String getActionCommand()
          ボタンのアクションコマンドを返します。
 int getMnemonic()
          モデルのキーボードニーモニックを取得します。
 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 s)
          ボタンが押されたときにイベントの一部として送られる、アクションコマンド文字列を設定します。
 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.awt.ItemSelectable から継承したメソッド
getSelectedObjects
 

メソッドの詳細

isArmed

public boolean isArmed()
ボタンがトリガー準備状態であるかどうかを示します。
戻り値:
ボタンがトリガー準備状態で、押下に備えた状態の場合は true
関連項目:
setArmed(boolean)

isSelected

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

isEnabled

public boolean isEnabled()
マウスポインタなどの入力デバイスで、ボタンの選択や押下ができるかどうかを示します。チェックボックスが選択され、通常のボタンは「押され」ます。
戻り値:
ボタンが有効で、選択または押下が可能な場合は true

isPressed

public boolean isPressed()
ボタンが押されたかどうかを示します。
戻り値:
ボタンが押された場合は true

isRollover

public boolean isRollover()
マウスポインタがボタンの上にあるかどうかを示します。
戻り値:
マウスポインタがボタンの上にある場合は true

setArmed

public void setArmed(boolean b)
ボタンをトリガー準備状態としてマークします。マウスがボタンの上にあるときにマウスボタンが離されると、ボタンのアクションイベントがトリガーされます。マウスがボタンの外に移動してからマウスボタンが離された場合は、ボタンのトリガー準備状態が解除されて、イベントはトリガーされません。
パラメータ:
b - ボタンをトリガー準備状態にして選択可能にする場合は true

setSelected

public void setSelected(boolean b)
ボタンを選択または選択解除します。
パラメータ:
b - ボタンを選択する場合は true、ボタンを選択解除する場合は false

setEnabled

public void setEnabled(boolean b)
ボタンを有効または無効にします。
パラメータ:
b - ボタンを有効にする場合は true
関連項目:
isEnabled()

setPressed

public void setPressed(boolean b)
ボタンを押された状態または押されていない状態に設定します。
パラメータ:
b - ボタンを「押された状態」に設定する場合は true
関連項目:
isPressed()

setRollover

public void setRollover(boolean b)
ボタンの反転状態を設定または解除します。
パラメータ:
b - 反転をオンにする場合は true
関連項目:
isRollover()

setMnemonic

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

getMnemonic

public int getMnemonic()
モデルのキーボードニーモニックを取得します。
戻り値:
アクセラレータキーを指定する int 値
関連項目:
setMnemonic(int)

setActionCommand

public void setActionCommand(String s)
ボタンが押されたときにイベントの一部として送られる、アクションコマンド文字列を設定します。
パラメータ:
s - 生成したイベントを識別する String

getActionCommand

public String getActionCommand()
ボタンのアクションコマンドを返します。
戻り値:
生成したイベントを識別する String
関連項目:
setActionCommand(java.lang.String)

setGroup

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

addActionListener

public void addActionListener(ActionListener l)
ボタンに ActionListener を追加します。
パラメータ:
l - 追加するリスナー

removeActionListener

public void removeActionListener(ActionListener l)
ボタンから ActionListener を削除します。
パラメータ:
l - 削除するリスナー

addItemListener

public void addItemListener(ItemListener l)
ボタンに ItemListener を追加します。
定義:
インタフェース ItemSelectable 内の addItemListener
パラメータ:
l - 追加するリスナー

removeItemListener

public void removeItemListener(ItemListener l)
ボタンから ItemListener を削除します。
定義:
インタフェース ItemSelectable 内の removeItemListener
パラメータ:
l - 削除するリスナー

addChangeListener

public void addChangeListener(ChangeListener l)
ボタンに ChangeListener を追加します。
パラメータ:
l - 追加するリスナー

removeChangeListener

public void removeChangeListener(ChangeListener l)
ボタンから ChangeListener を削除します。
パラメータ:
l - 削除するリスナー

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.