public interface ButtonModel extends ItemSelectable
このモデルは、チェックボックスやラジオ・ボタンなどの特殊なボタンにも、通常のボタンにも同様に使用します。あとで説明しますが、実際に状態を管理するためにモデル上でメソッドを呼び出すのは、ボタンのUIです。
簡単に言うと、通常のボタンの上でマウス・ボタンを押して指を離すと、ボタンがトリガーされ、ActionEvent
がトリガーされます。ボタンのルック・アンド・フィールによって定義されているキーボード・キー(典型例はスペース・バー)でも、同じ動作を行えます。ボタンがフォーカスされた状態でこのキーを押して指を離すと、同じ結果になります。チェックボックスとラジオ・ボタンの場合、ここで説明したようなマウスまたはキーボードの操作で、ボタンが選択されます。
詳しく述べると、ボタンの状態モデルは、マウスで使用した場合に、次のように動作します。
ボタンの上でマウスを押すと、モデルが作動準備完了で押下状態になります。マウスが押された状態であるかぎり、マウスをボタンの外側に移動しても、モデルは押下状態のままになります。逆に、ボタンの境界内でマウスを押下状態のままにしている間のみ、モデルが作動準備完了になります(ボタンの中や外に移動できますが、モデルはボタン内で費やされた時間の部分の間だけ作動準備完了になります)。モデルが作動準備完了状態の間にマウスが離される、つまり、マウスがそのボタンの上で以前に押されていた(およびまだ離されていない)後に、ボタンの上でマウスが離されると、ボタンがトリガーされ、ActionEvent
が起動されます。マウスが離されると、モデルの作動準備が解除され、押下されていない状態になります。
詳しく述べると、ボタンの状態モデルは、キーボードで使用した場合に、次のように動作します。
ボタンがフォーカスされている間に、ルック・アンド・フィール定義のキーボード・キーを押すと、モデルが作動準備完了で押下状態になります。このキーが押されたままであるかぎり、モデルはこの状態のままになります。キーを離すと、モデルが作動準備解除され、押下されていない状態に設定され、ボタンがトリガーされて、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)
ボタンを選択または選択解除します。
|
getSelectedObjects
boolean isArmed()
true
setArmed(boolean)
boolean isSelected()
true
boolean isEnabled()
true
boolean isPressed()
true
boolean isRollover()
true
void setArmed(boolean b)
b
- ボタンを作動準備状態にするかどうかvoid setSelected(boolean b)
b
- ボタンを選択する場合はtrue
、選択を解除する場合はfalse
void setEnabled(boolean b)
b
- ボタンを有効にするかどうかisEnabled()
void setPressed(boolean b)
b
- ボタンを押された状態にするかどうかisPressed()
void setRollover(boolean b)
b
- ボタンがロールオーバー状態かどうかisRollover()
void setMnemonic(int key)
key
- アクセラレータ・キーを指定する整数値int getMnemonic()
setMnemonic(int)
void setActionCommand(String s)
ActionEvent
の一部として送られるアクション・コマンド文字列を設定します。s
- 生成したイベントを識別するString
getActionCommand()
, ActionEvent.getActionCommand()
String getActionCommand()
String
setActionCommand(java.lang.String)
void setGroup(ButtonGroup group)
group
- ボタンが属するButtonGroup
void addActionListener(ActionListener l)
ActionListener
を追加します。l
- 追加するリスナーvoid removeActionListener(ActionListener l)
ActionListener
を削除します。l
- 削除するリスナーvoid addItemListener(ItemListener l)
ItemListener
を追加します。addItemListener
、インタフェース: ItemSelectable
l
- 追加するリスナーItemEvent
void removeItemListener(ItemListener l)
ItemListener
を削除します。removeItemListener
、インタフェース: ItemSelectable
l
- 削除するリスナーItemEvent
void addChangeListener(ChangeListener l)
ChangeListener
を追加します。l
- 追加するリスナーvoid removeChangeListener(ChangeListener l)
ChangeListener
を削除します。l
- 削除するリスナー バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2018, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。