Menu (JavaFX 8)

java.lang.Object
- javafx.scene.control.MenuItem
- - javafx.scene.control.Menu

すべての実装されたインタフェース:

Styleable、EventTarget
```
@DefaultProperty(value="items")
public class Menu
extends MenuItem
```
リクエスト時にのみユーザーに表示されるアクション可能なアイテムのポップアップ・メニュー。メニューが表示可能である場合、ほとんどのユースケースでは、ユーザーが1つのメニュー・アイテムを選択すると、メニューが非表示状態に戻ります。つまり、このメニューは、ユーザーに常に表示しておく必要がない重要な機能の配置に適しています。
通常、メニューはMenuBarに配置されるか、または別のメニューのサブメニューとして配置されます。ユーザーがユーザー・インタフェースの特定の領域で右クリックしたときにコンテキスト・メニューが表示されるようにすることを意図している場合、このコントロールを使用することは適切ではありません。これは、Menuをシーングラフに追加すると、そのビジュアルな表現が画面に表示されるためです。この場合は、かわりにContextMenuを使用します。
次のように、簡単にMenuを作成してMenuBarに挿入できます。
```
 final Menu menu1 = new Menu("File");
 MenuBar menuBar = new MenuBar();
 menuBar.getMenus().add(menu1);
 
```
MenuはMenuItemのサブクラスであるため、Menuのitems ObservableListに挿入してサブメニューを作成できます。
```
 MenuItem menu12 = new MenuItem("Open");
 menu1.getItems().add(menu12);
 
```
アイテムObservableListでは、そのサブクラスであるMenu、MenuItem、RadioMenuItem、CheckMenuItem、CustomMenuItem、SeparatorMenuItemを含め任意のMenuItemタイプを挿入できます。任意のNodeをメニューに挿入するには、CustomMenuItemを使用できます。この一般的なルールの1つの例外は、SeparatorMenuItemをセパレータの挿入に使用できることです。
導入されたバージョン:

JavaFX 2.0

関連項目:

MenuBar、MenuItem

プロパティのサマリー

すべてのメソッドインスタンス・メソッド具象メソッド
Type	プロパティと説明
`ObjectProperty<EventHandler<Event>>`	`onHidden` `ContextMenu`が非表示になった直後に呼び出されます。
`ObjectProperty<EventHandler<Event>>`	`onHiding` `ContextMenu`が非表示になる直前に呼び出されます。
`ObjectProperty<EventHandler<Event>>`	`onShowing` メニューに表示するアイテムがない場合でも、`ContextMenu`が表示される直前に呼び出されます。
`ObjectProperty<EventHandler<Event>>`	`onShown` `ContextMenu`が表示された直後に呼び出されます。
`ReadOnlyBooleanProperty`	`showing` `ContextMenu`が現在表示されているかどうかを示します。

クラス javafx.scene.control.MenuItemから継承されたプロパティ
accelerator, disable, graphic, id, mnemonicParsing, onAction, onMenuValidation, parentMenu, parentPopup, style, text, visible

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`static EventType<Event>`	`ON_HIDDEN` このメニューのcontextMenuが非表示になると呼び出されます。
`static EventType<Event>`	`ON_HIDING` このメニューのcontextMenuが非表示になると呼び出されます。
`static EventType<Event>`	`ON_SHOWING` このメニューのcontextMenuが表示されると呼び出されます。
`static EventType<Event>`	`ON_SHOWN` このメニューのcontextMenuが表示されると呼び出されます。

クラス javafx.scene.control.MenuItemから継承されたフィールド
MENU_VALIDATION_EVENT

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明
`Menu()` 表示テキストを空の文字列にしてメニューを構築します。
`Menu(String text)` メニューを構築し、指定されたテキストで表示テキストを設定します。
`Menu(String text, Node graphic)` メニューを構築し、指定されたテキストで表示テキストを設定し、グラフィック`Node`を指定されたノードに設定します。
`Menu(String text, Node graphic, MenuItem... items)` Menuを構築し、指定されたテキストで表示テキストを設定し、グラフィック`Node`を指定のノードに設定して、指定のアイテムを`items`リストに挿入します。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッドと説明
`<E extends Event> void`	`addEventHandler(EventType<E> eventType, EventHandler<E> eventHandler)` このMenuItemにイベント・ハンドラを登録します。
`EventDispatchChain`	`buildEventDispatchChain(EventDispatchChain tail)` このターゲットのイベント・ディスパッチ・チェーンを構築します。
`ObservableList<MenuItem>`	`getItems()` このメニュー内に表示するアイテム。
`EventHandler<Event>`	`getOnHidden()` プロパティonHiddenの値を取得します。
`EventHandler<Event>`	`getOnHiding()` プロパティonHidingの値を取得します。
`EventHandler<Event>`	`getOnShowing()` プロパティonShowingの値を取得します。
`EventHandler<Event>`	`getOnShown()` プロパティonShownの値を取得します。
`void`	`hide()` `ContextMenu` (すでに表示されていた場合)と、表示中のすべてのサブメニューを非表示にします。
`boolean`	`isShowing()` プロパティshowingの値を取得します。
`ObjectProperty<EventHandler<Event>>`	`onHiddenProperty()` `ContextMenu`が非表示になった直後に呼び出されます。
`ObjectProperty<EventHandler<Event>>`	`onHidingProperty()` `ContextMenu`が非表示になる直前に呼び出されます。
`ObjectProperty<EventHandler<Event>>`	`onShowingProperty()` メニューに表示するアイテムがない場合でも、`ContextMenu`が表示される直前に呼び出されます。
`ObjectProperty<EventHandler<Event>>`	`onShownProperty()` `ContextMenu`が表示された直後に呼び出されます。
`<E extends Event> void`	`removeEventHandler(EventType<E> eventType, EventHandler<E> eventHandler)` 以前に登録したイベント・ハンドラをこのMenuItemから登録解除します。
`void`	`setOnHidden(EventHandler<Event> value)` プロパティonHiddenの値を設定します。
`void`	`setOnHiding(EventHandler<Event> value)` プロパティonHidingの値を設定します。
`void`	`setOnShowing(EventHandler<Event> value)` プロパティonShowingの値を設定します。
`void`	`setOnShown(EventHandler<Event> value)` プロパティonShownの値を設定します。
`void`	`show()` メニューが無効ではなく、`ContextMenu`がまだ表示されていない場合は、`ContextMenu`が表示されます。
`ReadOnlyBooleanProperty`	`showingProperty()` `ContextMenu`が現在表示されているかどうかを示します。

クラス javafx.scene.control.MenuItemから継承されたメソッド
acceleratorProperty, disableProperty, fire, getAccelerator, getCssMetaData, getGraphic, getId, getOnAction, getOnMenuValidation, getParentMenu, getParentPopup, getProperties, getPseudoClassStates, getStyle, getStyleableParent, getStyleClass, getText, getTypeSelector, getUserData, graphicProperty, idProperty, isDisable, isMnemonicParsing, isVisible, mnemonicParsingProperty, onActionProperty, onMenuValidationProperty, parentMenuProperty, parentPopupProperty, setAccelerator, setDisable, setGraphic, setId, setMnemonicParsing, setOnAction, setOnMenuValidation, setParentMenu, setParentPopup, setStyle, setText, setUserData, setVisible, styleProperty, textProperty, toString, visibleProperty

クラス java.lang.Objectから継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- プロパティの詳細
  - showing
```
public final ReadOnlyBooleanProperty showingProperty
```
    ContextMenuが現在表示されているかどうかを示します。
    
    デフォルト値:
    
    false
    
    関連項目:
    
    isShowing()
  - onShowing
```
public final ObjectProperty<EventHandler<Event>> onShowingProperty
```
    メニューに表示するアイテムがない場合でも、ContextMenuが表示される直前に呼び出されます。ただし、メニューに有効なアンカー・ノードがない場合には呼び出されないことに注意してください。
    
    関連項目:
    
    getOnShowing()、setOnShowing(EventHandler)
  - onShown
```
public final ObjectProperty<EventHandler<Event>> onShownProperty
```
    ContextMenuが表示された直後に呼び出されます。
    
    関連項目:
    
    getOnShown()、setOnShown(EventHandler)
  - onHiding
```
public final ObjectProperty<EventHandler<Event>> onHidingProperty
```
    ContextMenuが非表示になる直前に呼び出されます。
    
    関連項目:
    
    getOnHiding()、setOnHiding(EventHandler)
  - onHidden
```
public final ObjectProperty<EventHandler<Event>> onHiddenProperty
```
    ContextMenuが非表示になった直後に呼び出されます。
    
    関連項目:
    
    getOnHidden()、setOnHidden(EventHandler)
- フィールドの詳細
  - ON_SHOWING
```
public static final EventType<Event> ON_SHOWING
```
    このメニューのcontextMenuが表示されると呼び出されます。ただし、contextMenuが空の場合は呼び出されません。
  - ON_SHOWN
```
public static final EventType<Event> ON_SHOWN
```
    このメニューのcontextMenuが表示されると呼び出されます。ただし、contextMenuが空の場合は呼び出されません。
  - ON_HIDING
```
public static final EventType<Event> ON_HIDING
```
    このメニューのcontextMenuが非表示になると呼び出されます。ただし、contextMenuが空の場合は呼び出されません。
  - ON_HIDDEN
```
public static final EventType<Event> ON_HIDDEN
```
    このメニューのcontextMenuが非表示になると呼び出されます。ただし、contextMenuが空の場合は呼び出されません。
- コンストラクタの詳細
  - Menu
```
public Menu()
```
    表示テキストを空の文字列にしてメニューを構築します。
    
    導入されたバージョン:
    
    JavaFX 2.2
  - Menu
```
public Menu(String text)
```
    メニューを構築し、指定されたテキストで表示テキストを設定します。
    
    パラメータ:
    
    text - メニュー・ボタンに表示するテキスト
  - Menu
```
public Menu(String text,
            Node graphic)
```
    メニューを構築し、指定されたテキストで表示テキストを設定し、グラフィックNodeを指定されたノードに設定します。
    
    パラメータ:
    
    text - メニュー・ボタンに表示するテキスト
    
    graphic - メニュー・ボタンに表示するグラフィック
  - Menu
```
public Menu(String text,
            Node graphic,
            MenuItem... items)
```
    Menuを構築し、指定されたテキストで表示テキストを設定し、グラフィックNodeを指定のノードに設定して、指定のアイテムをitemsリストに挿入します。
    
    パラメータ:
    
    text - メニュー・ボタンに表示するテキスト
    
    graphic - メニュー・ボタンに表示するグラフィック
    
    items - ポップアップ・メニューに表示するアイテム。
    
    導入されたバージョン:
    
    JavaFX 8u40
- メソッドの詳細
  - isShowing
```
public final boolean isShowing()
```
    プロパティshowingの値を取得します。
    
    プロパティの説明:
    
    ContextMenuが現在表示されているかどうかを示します。
    
    デフォルト値:
    
    false
  - showingProperty
```
public final ReadOnlyBooleanProperty showingProperty()
```
    ContextMenuが現在表示されているかどうかを示します。
    
    デフォルト値:
    
    false
    
    関連項目:
    
    isShowing()
  - onShowingProperty
```
public final ObjectProperty<EventHandler<Event>> onShowingProperty()
```
    メニューに表示するアイテムがない場合でも、ContextMenuが表示される直前に呼び出されます。ただし、メニューに有効なアンカー・ノードがない場合には呼び出されないことに注意してください。
    
    関連項目:
    
    getOnShowing()、setOnShowing(EventHandler)
  - setOnShowing
```
public final void setOnShowing(EventHandler<Event> value)
```
    プロパティonShowingの値を設定します。
    
    プロパティの説明:
    
    メニューに表示するアイテムがない場合でも、ContextMenuが表示される直前に呼び出されます。ただし、メニューに有効なアンカー・ノードがない場合には呼び出されないことに注意してください。
  - getOnShowing
```
public final EventHandler<Event> getOnShowing()
```
    プロパティonShowingの値を取得します。
    
    プロパティの説明:
    
    メニューに表示するアイテムがない場合でも、ContextMenuが表示される直前に呼び出されます。ただし、メニューに有効なアンカー・ノードがない場合には呼び出されないことに注意してください。
  - onShownProperty
```
public final ObjectProperty<EventHandler<Event>> onShownProperty()
```
    ContextMenuが表示された直後に呼び出されます。
    
    関連項目:
    
    getOnShown()、setOnShown(EventHandler)
  - setOnShown
```
public final void setOnShown(EventHandler<Event> value)
```
    プロパティonShownの値を設定します。
    
    プロパティの説明:
    
    ContextMenuが表示された直後に呼び出されます。
  - getOnShown
```
public final EventHandler<Event> getOnShown()
```
    プロパティonShownの値を取得します。
    
    プロパティの説明:
    
    ContextMenuが表示された直後に呼び出されます。
  - onHidingProperty
```
public final ObjectProperty<EventHandler<Event>> onHidingProperty()
```
    ContextMenuが非表示になる直前に呼び出されます。
    
    関連項目:
    
    getOnHiding()、setOnHiding(EventHandler)
  - setOnHiding
```
public final void setOnHiding(EventHandler<Event> value)
```
    プロパティonHidingの値を設定します。
    
    プロパティの説明:
    
    ContextMenuが非表示になる直前に呼び出されます。
  - getOnHiding
```
public final EventHandler<Event> getOnHiding()
```
    プロパティonHidingの値を取得します。
    
    プロパティの説明:
    
    ContextMenuが非表示になる直前に呼び出されます。
  - onHiddenProperty
```
public final ObjectProperty<EventHandler<Event>> onHiddenProperty()
```
    ContextMenuが非表示になった直後に呼び出されます。
    
    関連項目:
    
    getOnHidden()、setOnHidden(EventHandler)
  - setOnHidden
```
public final void setOnHidden(EventHandler<Event> value)
```
    プロパティonHiddenの値を設定します。
    
    プロパティの説明:
    
    ContextMenuが非表示になった直後に呼び出されます。
  - getOnHidden
```
public final EventHandler<Event> getOnHidden()
```
    プロパティonHiddenの値を取得します。
    
    プロパティの説明:
    
    ContextMenuが非表示になった直後に呼び出されます。
  - getItems
```
public final ObservableList<MenuItem> getItems()
```
    このメニュー内に表示するアイテム。このObservableListが実行時に変更された場合、メニューは想定どおりに更新されます。
  - show
```
public void show()
```
    メニューが無効ではなく、ContextMenuがまだ表示されていない場合は、ContextMenuが表示されます。
  - hide
```
public void hide()
```
    ContextMenu (すでに表示されていた場合)と、表示中のすべてのサブメニューを非表示にします。このメニューが表示されていない場合は、この関数を起動しても何も行われません。
  - addEventHandler
```
public <E extends Event> void addEventHandler(EventType<E> eventType,
                                              EventHandler<E> eventHandler)
```
    このMenuItemにイベント・ハンドラを登録します。ハンドラは、メニュー・アイテムがイベント配信のバブリング・フェーズ中に指定のタイプのEventを受け取ると呼び出されます。
    
    オーバーライド:
    
    addEventHandler、クラスMenuItem
    
    型パラメータ:
    
    E - ハンドラの特定のイベント・クラス
    
    パラメータ:
    
    eventType - ハンドラが受け取るイベントのタイプ
    
    eventHandler - 登録するハンドラ
  - removeEventHandler
```
public <E extends Event> void removeEventHandler(EventType<E> eventType,
                                                 EventHandler<E> eventHandler)
```
    以前に登録したイベント・ハンドラをこのMenuItemから登録解除します。 1つのハンドラが複数の異なるイベント・タイプに登録されているため、呼出し元はハンドラを登録解除する特定のイベント・タイプを指定する必要があります。
    
    オーバーライド:
    
    removeEventHandler、クラスMenuItem
    
    型パラメータ:
    
    E - ハンドラの特定のイベント・クラス
    
    パラメータ:
    
    eventType - 登録解除するイベント・タイプ
    
    eventHandler - 登録解除するハンドラ
  - buildEventDispatchChain
```
public EventDispatchChain buildEventDispatchChain(EventDispatchChain tail)
```
    このターゲットのイベント・ディスパッチ・チェーンを構築します。イベント・ディスパッチ・チェーンには、このEventTargetを対象にしたイベントの処理に関係する可能性があるイベント・ディスパッチャが含まれます。このイベント・ターゲットはチェーンに自動的には追加されないため、これがイベントを処理する場合は、それ自体のEventDispatcherをチェーンに追加する必要があります。
    イベント・ターゲットが階層の一部である場合、そのチェーンは通常、階層のルートからイベント・ターゲットまでの収集されたイベント・ディスパッチャから作成されます。
    イベント・ディスパッチ・チェーンは、提供される初期イベント・ディスパッチ・チェーンに対する変更によって構築されます。返されるチェーンでは初期チェーンが最後にある必要があるため、ディスパッチャは初期チェーンの前に追加される必要があります。
    呼出し元は、初期チェーンが変更されないままであることや、返される値によって異なるチェーンが参照されることを想定できません。
    
    定義:
    
    buildEventDispatchChain、インタフェースEventTarget
    
    オーバーライド:
    
    buildEventDispatchChain、クラスMenuItem
    
    パラメータ:
    
    tail - 構築元となる初期チェーン
    
    戻り値:
    
    このターゲットの結果のイベント・ディスパッチ・チェーン

クラスMenu

プロパティのサマリー

クラス javafx.scene.control.MenuItemから継承されたプロパティ

フィールドのサマリー

クラス javafx.scene.control.MenuItemから継承されたフィールド

コンストラクタのサマリー

メソッドのサマリー

クラス javafx.scene.control.MenuItemから継承されたメソッド

クラス java.lang.Objectから継承されたメソッド

プロパティの詳細

showing

onShowing

onShown

onHiding

onHidden

フィールドの詳細

ON_SHOWING

ON_SHOWN

ON_HIDING

ON_HIDDEN

コンストラクタの詳細

Menu

Menu

Menu

Menu

メソッドの詳細

isShowing

showingProperty

onShowingProperty

setOnShowing

getOnShowing

onShownProperty

setOnShown

getOnShown

onHidingProperty

setOnHiding

getOnHiding

onHiddenProperty

setOnHidden

getOnHidden

getItems

show

hide

addEventHandler

removeEventHandler

buildEventDispatchChain