JavaTM 2
Platform
Std. Ed. v1.4.0

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)
          ボタンが押されたときにイベントの一部として送られる 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.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 - アクセラレータキーを指定する整数値

getMnemonic

public int getMnemonic()
モデルのキーボードニーモニックを返します。

戻り値:
アクセラレータキーを指定する整数値
関連項目:
setMnemonic(int)

setActionCommand

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

パラメータ:
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 - 追加するリスナー
関連項目:
ItemEvent

removeItemListener

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

定義:
インタフェース ItemSelectable 内の removeItemListener
パラメータ:
l - 削除するリスナー
関連項目:
ItemEvent

addChangeListener

public void addChangeListener(ChangeListener l)
ボタンに ChangeListener を追加します。

パラメータ:
l - 追加するリスナー

removeChangeListener

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

パラメータ:
l - 削除するリスナー

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.