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

クラスToggleButton

  • すべての実装されたインタフェース:
    Styleable, EventTarget, Skinnable, Toggle
    直系の既知のサブクラス:
    RadioButton

    public class ToggleButton
extends ButtonBase
implements Toggle
    ToggleButtonは、選択可能な特殊コントロールです。 通常、ToggleButtonはボタンのようにレンダリングされます。 ただし、それらは2つの異なるタイプのコントロールです。 ボタンは、クリックしたときに関数を起動するコマンド・ボタンです。 一方、ToggleButtonは、単に、選択されているかどうかを示すブールを使用したコントロールです。

    ToggleButtonはグループに配置することもできます。 デフォルトでは、ToggleButtonはグループに属しません。 グループに含めると、そのグループ内で一度に1つのToggleButtonのみを選択できます。 同じグループに2つのToggleButtonsを配置するには、単にそれらの両方にToggleGroupに同じ値を割り当てます。

    RadioButtonsとは異なり、ToggleGroup内のToggleButtonsでは、グループ内のToggleButtonが強制的に1つ以上選択されるようにしません。 つまり、ToggleButtonが選択されている場合は、それをクリックするとそれが未選択になります。 RadioButtonでは、グループ内の選択されたボタンをクリックしても効果はありません。

    例:

    
 ToggleButton tb1 = new ToggleButton("toggle button 1");
 ToggleButton tb2 = new ToggleButton("toggle button 2");
 ToggleButton tb3 = new ToggleButton("toggle button 3");
 ToggleGroup group = new ToggleGroup();
 tb1.setToggleGroup(group);
 tb2.setToggleGroup(group);
 tb3.setToggleGroup(group);

    ToggleButtonでは、MnemonicParsingはデフォルトで有効化されています。

    導入されたバージョン:
    JavaFX 2.0

    • コンストラクタの詳細

      • ToggleButton

        public ToggleButton​()
        そのラベルの文字列を空にして、トグル・ボタンを作成します。

      • ToggleButton

        public ToggleButton​(String text)
        指定されたテキストをそのラベルとして、トグル・ボタンを作成します。
        パラメータ:
        text - そのラベルのテキスト文字列。

      • ToggleButton

        public ToggleButton​(String text,
                    Node graphic)
        トグル・ボタンを、そのラベル用の指定されたテキストおよびアイコンで作成します。
        パラメータ:
        text - そのラベルのテキスト文字列。
        graphic - そのラベルのアイコン。

    • メソッドの詳細

      • setSelected

        public final void setSelected​(boolean value)
        プロパティselectedの値を設定します。
        定義:
        setSelected 、インタフェース: Toggle
        プロパティの説明:
        このトグルのボタンが選択されているかどうかを示します。 これは、プログラムで操作できます。
        パラメータ:
        value - value - このToggleを選択するにはtrue。

      • isSelected

        public final boolean isSelected​()
        プロパティselectedの値を取得します。
        定義:
        isSelected 、インタフェース: Toggle
        プロパティの説明:
        このトグルのボタンが選択されているかどうかを示します。 これは、プログラムで操作できます。
        戻り値:
        このToggleが選択されている場合はtrue。

      • setToggleGroup

        public final void setToggleGroup​(ToggleGroup value)
        プロパティtoggleGroupの値を設定します。
        定義:
        setToggleGroup 、インタフェース: Toggle
        プロパティの説明:
        このToggleButtonが属するToggleGroup。 ToggleButtonは、いつでも1つのグループに配置できます。 グループが変更されると、ボタンは新しいグループに追加される前に、古いグループから削除されます。
        パラメータ:
        value - 新しいToggleGroup。

      • getToggleGroup

        public final ToggleGroup getToggleGroup​()
        プロパティtoggleGroupの値を取得します。
        定義:
        getToggleGroup 、インタフェース: Toggle
        プロパティの説明:
        このToggleButtonが属するToggleGroup。 ToggleButtonは、いつでも1つのグループに配置できます。 グループが変更されると、ボタンは新しいグループに追加される前に、古いグループから削除されます。
        戻り値:
        このToggleが属するToggleGroup。

      • fire

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

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

        定義:
        fire 、クラス: ButtonBase

      • createDefaultSkin

        protected Skin<?> createDefaultSkin​()
        このコントロールのデフォルト・スキンの新しいインスタンスを作成します。 これは、CSS -fx-skinを介してスキンが提供されていない場合にコントロール用のスキンを作成するために、または setSkin(...)を使用してサブクラスで明示的に設定するために呼び出されます。
        オーバーライド:
        createDefaultSkin 、クラス: Control
        戻り値:
        このコントロールのデフォルト・スキンの新しいインスタンス。 nullの場合、コントロールにはスキンがありません(Cssで提供されている場合を除く)。

      • getInitialAlignment

        protected Pos getInitialAlignment​()
        JavaFX CSSエンジンが初期値を正しく設定するために使用する、このコントロールの初期整列状態を返します。 このメソッドは、最初はPos.CENTERを使用するようにオーバーライドされています。
        オーバーライド:
        クラスLabeledのgetInitialAlignment
        戻り値:
        このコントロールの初期の整列状態
        導入されたバージョン:
        9

      • queryAccessibleAttribute

        public Object queryAccessibleAttribute​(AccessibleAttribute attribute,
                                       Object... parameters)
        このメソッドは、属性の値をリクエストするためにアシスティブ・テクノロジによって呼び出されます。

        このメソッドは一般に、特定の役割に必要な属性を実装するためにサブクラスによってオーバーライドされます。
        特定の属性が処理されない場合は、スーパークラスの実装を呼び出す必要があります。

        オーバーライド:
        queryAccessibleAttribute、クラス: Control
        パラメータ:
        attribute - リクエストされた属性
        parameters - オプションのパラメータ・リスト
        戻り値:
        リクエストされた属性の値
        関連項目:
        AccessibleAttribute