モジュール javafx.controls
パッケージ javafx.scene.control

クラスButtonBase

  • すべての実装されたインタフェース:
    Styleable, EventTarget, Skinnable
    直系の既知のサブクラス:
    Button, CheckBox, Hyperlink, MenuButton, ToggleButton
    public abstract class ButtonBase
extends Labeled
    Hyperlink、Button、ToggleButton、CheckBoxe、RadioButtonなどのボタン形式のUIコントロールのベース・クラス。 ButtonBaseの主な役割は、ボタン作動準備の概念を処理するための一貫性のあるAPIを提供することです。 UIでは、通常、ボタンが作動準備完了しているときになんらかのユーザーのジェスチャが発生すると、ボタンが単に起動されます。 たとえば、マウスが押され、ボタンが有効化され、マウスがそのボタンの上に置かれている場合、そのボタンは作動準備完了しています。 このような状況で、その後、マウスが放されると、そのボタンが起動される、つまりそのアクションが実行されます。
    導入されたバージョン:
    JavaFX 2.0

    • プロパティの詳細

      • armed

        public final ReadOnlyBooleanProperty armedProperty
        マウスを放すとボタンのアクションが起動するようにボタンが準備されていることを示します。 これは、押下とは微妙に異なります。 押下は、ノード上でマウスが押され、まだ放されていないことを示します。一方、armでは、マウスが実際にボタン上に置かれて押されているかどうかも考慮されます。
        関連項目:
        isArmed()

      • onAction

        public final ObjectProperty<EventHandler<ActionEvent>> onActionProperty
        ボタンが起動されると常に起動されるボタンのアクション。 このことは、ユーザーがマウス、タッチ・イベント、またはキー・プレスによってボタンをクリックしたか、または開発者がプログラムによってfire()メソッドを起動したために発生します。
        関連項目:
        getOnAction()、setOnAction(EventHandler)

    • コンストラクタの詳細

      • ButtonBase

        public ButtonBase()
        空のテキストを含むデフォルトのButtonBaseを作成します。

      • ButtonBase

        public ButtonBase​(String text)
        指定されたテキストを持つButtonBaseを作成します。
        パラメータ:
        text - nullテキストは空の文字列として処理されます。

      • ButtonBase

        public ButtonBase​(String text,
                  Node graphic)
        指定されたテキストとグラフィックを持つButtonBaseを作成します。
        パラメータ:
        text - nullテキストは空の文字列として処理されます。
        graphic - nullグラフィックは許容されます。

    • メソッドの詳細

      • armedProperty

        public final ReadOnlyBooleanProperty armedProperty()
        マウスを放すとボタンのアクションが起動するようにボタンが準備されていることを示します。 これは、押下とは微妙に異なります。 押下は、ノード上でマウスが押され、まだ放されていないことを示します。一方、armでは、マウスが実際にボタン上に置かれて押されているかどうかも考慮されます。
        関連項目:
        isArmed()

      • isArmed

        public final boolean isArmed()
        プロパティarmedの値を取得します。
        プロパティの説明:
        マウスを放すとボタンのアクションが起動するようにボタンが準備されていることを示します。 これは、押下とは微妙に異なります。 押下は、ノード上でマウスが押され、まだ放されていないことを示します。一方、armでは、マウスが実際にボタン上に置かれて押されているかどうかも考慮されます。

      • onActionProperty

        public final ObjectProperty<EventHandler<ActionEvent>> onActionProperty()
        ボタンが起動されると常に起動されるボタンのアクション。 このことは、ユーザーがマウス、タッチ・イベント、またはキー・プレスによってボタンをクリックしたか、または開発者がプログラムによってfire()メソッドを起動したために発生します。
        関連項目:
        getOnAction()、setOnAction(EventHandler)

      • setOnAction

        public final void setOnAction​(EventHandler<ActionEvent> value)
        プロパティonActionの値を設定します。
        プロパティの説明:
        ボタンが起動されると常に起動されるボタンのアクション。 このことは、ユーザーがマウス、タッチ・イベント、またはキー・プレスによってボタンをクリックしたか、または開発者がプログラムによってfire()メソッドを起動したために発生します。

      • getOnAction

        public final EventHandler<ActionEvent> getOnAction()
        プロパティonActionの値を取得します。
        プロパティの説明:
        ボタンが起動されると常に起動されるボタンのアクション。 このことは、ユーザーがマウス、タッチ・イベント、またはキー・プレスによってボタンをクリックしたか、または開発者がプログラムによってfire()メソッドを起動したために発生します。

      • arm

        public void arm()
        ボタンを作動準備します。 作動準備完了したボタンは、次に想定されるUIジェスチャに関するアクション(Button、CheckBoxでの選択肢の切替え、またはその他の動作のアクション)を起動します。 ノート: この機能は、主に新しいスキンまたはビヘイビアを実装する者が専門家によって使用されることを意図しています。 開発者や設計者がこの機能に直接アクセスするのは一般的ではありません。

      • disarm

        public void disarm()
        ボタンの作動準備を解除します。 arm()を参照してください。 ノート: この機能は、主に新しいスキンまたはビヘイビアを実装する者が専門家によって使用されることを意図しています。 開発者や設計者がこの機能に直接アクセスするのは一般的ではありません。

      • fire

        public abstract void fire()
        このButtonBaseのイベントが発生する必要があることをユーザーのジェスチャが示している場合に起動されます。

        このメソッドは、起動されると、arm()のステータスに関係なく実行されます。