ButtonModel (Java Platform SE 7)

すべてのスーパーインタフェース:

ItemSelectable

既知のすべての実装クラス:

DefaultButtonModel, JToggleButton.ToggleButtonModel
```
public interface ButtonModel
extends ItemSelectable
```
ボタンの状態モデルです。
このモデルは、チェックボックスやラジオボタンなどの特殊なボタンにも、通常のボタンにも同様に使用します。あとで説明しますが、実際に状態を管理するためにモデル上でメソッドを呼び出すのは、ボタンの UI です。
簡単に言うと、通常のボタンの上でマウスボタンを押して指を離すと、ボタンがトリガーされ、ActionEvent がトリガーされます。ボタンの Look & Feel によって定義されているキーボードキー (典型例はスペースバー) でも、同じ動作を行えます。ボタンがフォーカスされた状態でこのキーを押して指を離すと、同じ結果になります。チェックボックスとラジオボタンの場合、ここで説明したようなマウスまたはキーボードの操作で、ボタンが選択されます。
ボタンの状態モデルは、マウスの操作により、次のように機能します。
ボタン上でマウスボタンを押すと、モデルは作動準備状態および押された状態になります。マウスボタンを押し下げている間は、マウスをボタンの外側へ移動しても、モデルでは押された状態のままになります。反対に、モデルが作動準備状態になるのは、ボタンの境界内でマウスボタンが押されている間のみです。マウスをボタンの外側へ移動することはできますが、モデルが作動準備状態になるのは、マウスがボタンの境界内にある間だけです。モデルが作動準備状態になっている間にマウスボタンから指を離すと、つまり、ボタン上でマウスボタンを押したあと (指を離さないまま維持し)、ボタンの上で指を離すと、ボタンがトリガーされ、ActionEvent がトリガーされます。マウスボタンから指を離した瞬間、モデルの作動準備状態と押された状態が解除されます。
ボタンの状態モデルは、キーボードの操作により、次のように機能します。
ボタンにフォーカスがある状態で、Look & Feel によって定義されたキーボードキーを押すと、モデルは作動準備状態および押された状態になります。このキーを押している間、モデルはこの状態を保持します。キーから指を離すと、モデルの作動準備状態と押された状態が解除され、ボタンがトリガーされ、これを受けて ActionEvent がトリガーされます。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`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)` ボタンがトリガーされたときに `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.awt.ItemSelectable から継承されたメソッド
getSelectedObjects

- メソッドの詳細
  - isArmed
```
boolean isArmed()
```
    ボタンが作動準備状態であることを示します。
    
    戻り値:
    ボタンが作動準備状態で、トリガーされる準備ができている場合は true
    関連項目:
    setArmed(boolean)
  - isSelected
```
boolean isSelected()
```
    ボタンが選択されているかどうかを示します。ラジオボタンやチェックボックスなどの特定の種類のボタンにだけ必要です。
    
    戻り値:
    ボタンが選択されている場合は true
  - isEnabled
```
boolean isEnabled()
```
    マウスポインタなどの入力デバイスで、ボタンを選択したり、トリガーしたりできるかどうかを示します。
    
    戻り値:
    ボタンが有効な場合は true
  - isPressed
```
boolean isPressed()
```
    ボタンが押されているかどうかを示します。
    
    戻り値:
    ボタンが押されている場合は true
  - isRollover
```
boolean isRollover()
```
    マウスポインタがボタンの上にあるかどうかを示します。
    
    戻り値:
    マウスポインタがボタンの上にある場合は true
  - setArmed
```
void setArmed(boolean b)
```
    ボタンを作動準備状態または作動準備が解除された状態としてマークします。
    
    パラメータ:
    b - ボタンを作動準備状態にするかどうか
  - setSelected
```
void setSelected(boolean b)
```
    ボタンを選択または選択解除します。
    
    パラメータ:
    b - ボタンを選択する場合は true、選択を解除する場合は false
  - setEnabled
```
void setEnabled(boolean b)
```
    ボタンを有効または無効にします。
    
    パラメータ:
    b - ボタンを有効にするかどうか
    関連項目:
    isEnabled()
  - setPressed
```
void setPressed(boolean b)
```
    ボタンを押された状態または押されていない状態に設定します。
    
    パラメータ:
    b - ボタンを押された状態にするかどうか
    関連項目:
    isPressed()
  - setRollover
```
void setRollover(boolean b)
```
    ボタンのロールオーバー状態を設定または解除します。
    
    パラメータ:
    b - ボタンがロールオーバー状態かどうか
    関連項目:
    isRollover()
  - setMnemonic
```
void setMnemonic(int key)
```
    ボタンのキーボードニーモニック (ショートカットキーまたはアクセラレータキー) を設定します。
    
    パラメータ:
    key - アクセラレータキーを指定する整数値
  - getMnemonic
```
int getMnemonic()
```
    ボタンのキーボードニーモニックを返します。
    
    戻り値:
    アクセラレータキーを指定する整数値
    関連項目:
    setMnemonic(int)
  - setActionCommand
```
void setActionCommand(String s)
```
    ボタンがトリガーされたときに ActionEvent の一部として送られるアクションコマンド文字列を設定します。
    
    パラメータ:
    s - 生成したイベントを識別する String
    関連項目:
    getActionCommand(), ActionEvent.getActionCommand()
  - getActionCommand
```
String getActionCommand()
```
    ボタンのアクションコマンド文字列を返します。
    
    戻り値:
    生成したイベントを識別する String
    関連項目:
    setActionCommand(java.lang.String)
  - setGroup
```
void setGroup(ButtonGroup group)
```
    ボタンが属するグループを識別します。これは、グループ内で排他的な選択をするラジオボタンに必要です。
    
    パラメータ:
    group - ボタンが属する ButtonGroup
  - addActionListener
```
void addActionListener(ActionListener l)
```
    モデルに ActionListener を追加します。
    
    パラメータ:
    l - 追加するリスナー
  - removeActionListener
```
void removeActionListener(ActionListener l)
```
    モデルから ActionListener を削除します。
    
    パラメータ:
    l - 削除するリスナー
  - addItemListener
```
void addItemListener(ItemListener l)
```
    モデルに ItemListener を追加します。
    
    定義:
    
    addItemListener、インタフェース: ItemSelectable
    
    パラメータ:
    l - 追加するリスナー
    関連項目:
    ItemEvent
  - removeItemListener
```
void removeItemListener(ItemListener l)
```
    モデルから ItemListener を削除します。
    
    定義:
    
    removeItemListener、インタフェース: ItemSelectable
    
    パラメータ:
    l - 削除するリスナー
    関連項目:
    ItemEvent
  - addChangeListener
```
void addChangeListener(ChangeListener l)
```
    モデルに ChangeListener を追加します。
    
    パラメータ:
    l - 追加するリスナー
  - removeChangeListener
```
void removeChangeListener(ChangeListener l)
```
    モデルから ChangeListener を削除します。
    
    パラメータ:
    l - 削除するリスナー

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

インタフェース ButtonModel

メソッドのサマリー

インタフェース java.awt.ItemSelectable から継承されたメソッド

メソッドの詳細

isArmed

isSelected

isEnabled

isPressed

isRollover

setArmed

setSelected

setEnabled

setPressed

setRollover

setMnemonic

getMnemonic

setActionCommand

getActionCommand

setGroup

addActionListener

removeActionListener

addItemListener

removeItemListener

addChangeListener

removeChangeListener