モジュール java.desktop
パッケージ javax.swing

インタフェースButtonModel

すべてのスーパー・インタフェース:
ItemSelectable
既知のすべての実装クラス:
DefaultButtonModel, JToggleButton.ToggleButtonModel
public interface ButtonModel extends ItemSelectable
ボタンの状態モデルです。

このモデルは、チェックボックスやラジオ・ボタンなどの特殊なボタンにも、通常のボタンにも同様に使用します。 あとで説明しますが、実際に状態を管理するためにモデル上でメソッドを呼び出すのは、ボタンのUIです。

簡単に言うと、通常のボタンの上でマウス・ボタンを押して指を離すと、ボタンがトリガーされ、ActionEventがトリガーされます。 ボタンのルック・アンド・フィールによって定義されているキーボード・キー(典型例はスペース・バー)でも、同じ動作を行えます。 ボタンがフォーカスされた状態でこのキーを押して指を離すと、同じ結果になります。 チェックボックスとラジオ・ボタンの場合、ここで説明したようなマウスまたはキーボードの操作で、ボタンが選択されます。

詳しく述べると、ボタンの状態モデルは、マウスで使用した場合に、次のように動作します。
ボタンの上でマウスを押すと、モデルが作動準備完了で押下状態になります。 マウスが押された状態であるかぎり、マウスをボタンの外側に移動しても、モデルは押下状態のままになります。 逆に、ボタンの境界内でマウスを押下状態のままにしている間のみ、モデルが作動準備完了になります(ボタンの中や外に移動できますが、モデルはボタン内で費やされた時間の部分の間だけ作動準備完了になります)。 モデルが作動準備完了状態の間にマウスが離される、つまり、マウスがそのボタンの上で以前に押されていた(およびまだ離されていない)後に、ボタンの上でマウスが離されると、ボタンがトリガーされ、ActionEventが起動されます。 マウスが離されると、モデルの作動準備が解除され、押下されていない状態になります。

詳しく述べると、ボタンの状態モデルは、キーボードで使用した場合に、次のように動作します。
ボタンがフォーカスされている間に、ルック・アンド・フィール定義のキーボード・キーを押すと、モデルが作動準備完了で押下状態になります。 このキーが押されたままであるかぎり、モデルはこの状態のままになります。 キーを離すと、モデルが作動準備解除され、押下されていない状態に設定され、ボタンがトリガーされて、ActionEventが起動されます。

導入されたバージョン:
1.2