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

クラスMenuButton

  • すべての実装されたインタフェース:
    Styleable, EventTarget, Skinnable
    直系の既知のサブクラス:
    SplitMenuButton
    public class MenuButton
extends ButtonBase
    MenuButtonは、クリックするか、押したときにContextMenuが表示されるボタンです。 MenuButtonは、items ObservableListに表示されるアイテムを設定し、MenuButton内に表示されるラベルを指定するtextプロパティがあるので、Menuコントロールと非常によく似たAPIを共有します。

    前述のとおり、Menu API自体と同様に、items ObservableListでは、MenuItemから拡張したアイテムを提供できます。 MenuItemの有用なサブクラスには、RadioMenuItem、CheckMenuItem、Menu、SeparatorMenuItem、CustomMenuItemなどがあります。

    MenuButtonは、ボタンの任意の側にメニューを表示するように設定できます。 これを指定するには、popupSideプロパティを使用します。 デフォルトでは、メニューはボタンの下に表示されます。 ただし、popupSideの指定に関係なく、十分な領域がない場合には、ContextMenuは適宜(通常はMenuButtonの反対側に)配置されます。

    例:

     MenuButton m = new MenuButton("Eats");
 m.getItems().addAll(new MenuItem("Burger"), new MenuItem("Hot Dog"));

    MnemonicParsingは、MenuButtonではデフォルトで有効になっています。

    導入されたバージョン:
    JavaFX 2.0
    関連項目:
    MenuItem、Menu、SplitMenuButton

    • フィールドの詳細

      • ON_SHOWING

        public static final EventType<Event> ON_SHOWING
        ユーザーがクリックしたか、そうでなければMenuButtonとやりとりした後で、そのポップアップを示すMenuButtonの前に呼び出されます。
        導入されたバージョン:
        JavaFX 8u60

      • ON_SHOWN

        public static final EventType<Event> ON_SHOWN
        MenuButtonがポップアップを表示した後に呼び出されます。
        導入されたバージョン:
        JavaFX 8u60

      • ON_HIDING

        public static final EventType<Event> ON_HIDING
        MenuButtonポップアップwillが非表示になったときに呼び出されます。
        導入されたバージョン:
        JavaFX 8u60

      • ON_HIDDEN

        public static final EventType<Event> ON_HIDDEN
        MenuButtonポップアップが非表示になったときに呼び出されます。
        導入されたバージョン:
        JavaFX 8u60

    • コンストラクタの詳細

      • MenuButton

        public MenuButton​(String text)
        新しい空のメニュー・ボタンを作成し、指定されたテキストがボタンに表示されるようにします。 Labeled.setGraphic(Node)およびgetItems()を使用して、そのコンテンツを設定します。
        パラメータ:
        text - メニュー・ボタンに表示するテキスト

      • MenuButton

        public MenuButton​(String text,
                  Node graphic)
        新しい空のメニュー・ボタンを作成し、指定されたテキストとグラフィックがボタンに表示されるようにします。 getItems()を使用して、そのコンテンツを設定します。
        パラメータ:
        text - メニュー・ボタンに表示するテキスト
        graphic - メニュー・ボタンに表示するグラフィック

      • MenuButton

        public MenuButton​(String text,
                  Node graphic,
                  MenuItem... items)
        新しい空のメニュー・ボタンを作成して、指定されたテキストとグラフィックがボタンに表示されるようにし、指定されたアイテムをitemsリストに挿入します。
        パラメータ:
        text - メニュー・ボタンに表示するテキスト
        graphic - メニュー・ボタンに表示するグラフィック
        items - ポップアップ・メニューに表示するアイテム。
        導入されたバージョン:
        JavaFX 8u40

    • メソッドの詳細

      • getItems

        public final ObservableList<MenuItem> getItems()
        このボタン・メニュー内に表示するアイテム。 このObservableListが実行時に変更された場合、メニューは想定どおりに更新されます。

        よく使用されるコントロールには、MenuItem、CheckMenuItem、RadioMenuItemなどに加えて、メニューに追加するとサブメニューになる、Menuがあります。 SeparatorMenuItemも、MenuのアイテムObservableListでよく使用されるノードです。

        戻り値:
        このボタン・メニュー内のメニュー・アイテムのリスト

      • isShowing

        public final boolean isShowing()
        プロパティshowingの値を取得します。
        プロパティの説明:
        ContextMenuが現在表示されているかどうかを示します。

      • setPopupSide

        public final void setPopupSide​(Side value)
        プロパティpopupSideの値を設定します。
        プロパティの説明:
        MenuButtonについて、どちら側でContextMenuを開くかを示します。 メニュー・アイテムは、通常、いずれの場合も垂直にレイアウトされます。 たとえば、メニュー・ボタンがアプリケーションの左端の垂直ツールバーにある場合、popupSideをSide.RIGHTに変更すると、MenuButtonの右側にポップアップが表示されるようになります。
        デフォルト値:
        Side.BOTTOM

      • getPopupSide

        public final Side getPopupSide()
        プロパティpopupSideの値を取得します。
        プロパティの説明:
        MenuButtonについて、どちら側でContextMenuを開くかを示します。 メニュー・アイテムは、通常、いずれの場合も垂直にレイアウトされます。 たとえば、メニュー・ボタンがアプリケーションの左端の垂直ツールバーにある場合、popupSideをSide.RIGHTに変更すると、MenuButtonの右側にポップアップが表示されるようになります。
        デフォルト値:
        Side.BOTTOM

      • popupSideProperty

        public final ObjectProperty<Side> popupSideProperty()
        MenuButtonについて、どちら側でContextMenuを開くかを示します。 メニュー・アイテムは、通常、いずれの場合も垂直にレイアウトされます。 たとえば、メニュー・ボタンがアプリケーションの左端の垂直ツールバーにある場合、popupSideをSide.RIGHTに変更すると、MenuButtonの右側にポップアップが表示されるようになります。
        デフォルト値:
        Side.BOTTOM
        関連項目:
        getPopupSide()、setPopupSide(Side)

      • setOnShowing

        public final void setOnShowing​(EventHandler<Event> value)
        プロパティonShowingの値を設定します。
        プロパティの説明:
        ContextMenuが表示される直前に呼び出されます。
        導入されたバージョン:
        10

      • getOnShowing

        public final EventHandler<Event> getOnShowing()
        プロパティonShowingの値を取得します。
        プロパティの説明:
        ContextMenuが表示される直前に呼び出されます。
        導入されたバージョン:
        10

      • setOnShown

        public final void setOnShown​(EventHandler<Event> value)
        プロパティonShownの値を設定します。
        プロパティの説明:
        ContextMenuが表示された直後に呼び出されます。
        導入されたバージョン:
        10

      • getOnShown

        public final EventHandler<Event> getOnShown()
        プロパティonShownの値を取得します。
        プロパティの説明:
        ContextMenuが表示された直後に呼び出されます。
        導入されたバージョン:
        10

      • setOnHiding

        public final void setOnHiding​(EventHandler<Event> value)
        プロパティonHidingの値を設定します。
        プロパティの説明:
        ContextMenuが非表示になる直前に呼び出されます。
        導入されたバージョン:
        10

      • getOnHiding

        public final EventHandler<Event> getOnHiding()
        プロパティonHidingの値を取得します。
        プロパティの説明:
        ContextMenuが非表示になる直前に呼び出されます。
        導入されたバージョン:
        10

      • setOnHidden

        public final void setOnHidden​(EventHandler<Event> value)
        プロパティonHiddenの値を設定します。
        プロパティの説明:
        ContextMenuが非表示になった直後に呼び出されます。
        導入されたバージョン:
        10

      • getOnHidden

        public final EventHandler<Event> getOnHidden()
        プロパティonHiddenの値を取得します。
        プロパティの説明:
        ContextMenuが非表示になった直後に呼び出されます。
        導入されたバージョン:
        10

      • fire

        public void fire()
        これは何も行いません。
        定義:
        fire 、クラス: ButtonBase