@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
をセパレータの挿入に使用できることです。
Type | プロパティと説明 |
---|---|
ObjectProperty<EventHandler<Event>> |
onHidden
ContextMenu が非表示になった直後に呼び出されます。 |
ObjectProperty<EventHandler<Event>> |
onHiding
ContextMenu が非表示になる直前に呼び出されます。 |
ObjectProperty<EventHandler<Event>> |
onShowing
メニューに表示するアイテムがない場合でも、
ContextMenu が表示される直前に呼び出されます。 |
ObjectProperty<EventHandler<Event>> |
onShown
ContextMenu が表示された直後に呼び出されます。 |
ReadOnlyBooleanProperty |
showing
ContextMenu が現在表示されているかどうかを示します。 |
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が表示されると呼び出されます。
|
MENU_VALIDATION_EVENT
コンストラクタと説明 |
---|
Menu()
表示テキストを空の文字列にしてメニューを構築します。
|
Menu(String text)
メニューを構築し、指定されたテキストで表示テキストを設定します。
|
Menu(String text, Node graphic)
メニューを構築し、指定されたテキストで表示テキストを設定し、グラフィック
Node を指定されたノードに設定します。 |
Menu(String text, Node graphic, MenuItem... items)
|
修飾子と型 | メソッドと説明 |
---|---|
<E extends Event> |
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> |
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 が現在表示されているかどうかを示します。 |
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
public final ReadOnlyBooleanProperty showingProperty
ContextMenu
が現在表示されているかどうかを示します。isShowing()
public final ObjectProperty<EventHandler<Event>> onShowingProperty
ContextMenu
が表示される直前に呼び出されます。ただし、メニューに有効なアンカー・ノードがない場合には呼び出されないことに注意してください。public final ObjectProperty<EventHandler<Event>> onShownProperty
ContextMenu
が表示された直後に呼び出されます。public final ObjectProperty<EventHandler<Event>> onHidingProperty
ContextMenu
が非表示になる直前に呼び出されます。public final ObjectProperty<EventHandler<Event>> onHiddenProperty
ContextMenu
が非表示になった直後に呼び出されます。public static final EventType<Event> ON_SHOWING
このメニューのcontextMenuが表示されると呼び出されます。ただし、contextMenuが空の場合は呼び出されません。
public static final EventType<Event> ON_SHOWN
このメニューのcontextMenuが表示されると呼び出されます。ただし、contextMenuが空の場合は呼び出されません。
public static final EventType<Event> ON_HIDING
このメニューのcontextMenuが非表示になると呼び出されます。ただし、contextMenuが空の場合は呼び出されません。
public Menu()
public Menu(String text)
text
- メニュー・ボタンに表示するテキストpublic Menu(String text, Node graphic)
Node
を指定されたノードに設定します。text
- メニュー・ボタンに表示するテキストgraphic
- メニュー・ボタンに表示するグラフィックpublic final boolean isShowing()
ContextMenu
が現在表示されているかどうかを示します。public final ReadOnlyBooleanProperty showingProperty()
ContextMenu
が現在表示されているかどうかを示します。isShowing()
public final ObjectProperty<EventHandler<Event>> onShowingProperty()
ContextMenu
が表示される直前に呼び出されます。ただし、メニューに有効なアンカー・ノードがない場合には呼び出されないことに注意してください。public final void setOnShowing(EventHandler<Event> value)
ContextMenu
が表示される直前に呼び出されます。ただし、メニューに有効なアンカー・ノードがない場合には呼び出されないことに注意してください。public final EventHandler<Event> getOnShowing()
ContextMenu
が表示される直前に呼び出されます。ただし、メニューに有効なアンカー・ノードがない場合には呼び出されないことに注意してください。public final ObjectProperty<EventHandler<Event>> onShownProperty()
ContextMenu
が表示された直後に呼び出されます。public final void setOnShown(EventHandler<Event> value)
ContextMenu
が表示された直後に呼び出されます。public final EventHandler<Event> getOnShown()
ContextMenu
が表示された直後に呼び出されます。public final ObjectProperty<EventHandler<Event>> onHidingProperty()
ContextMenu
が非表示になる直前に呼び出されます。public final void setOnHiding(EventHandler<Event> value)
ContextMenu
が非表示になる直前に呼び出されます。public final EventHandler<Event> getOnHiding()
ContextMenu
が非表示になる直前に呼び出されます。public final ObjectProperty<EventHandler<Event>> onHiddenProperty()
ContextMenu
が非表示になった直後に呼び出されます。public final void setOnHidden(EventHandler<Event> value)
ContextMenu
が非表示になった直後に呼び出されます。public final EventHandler<Event> getOnHidden()
ContextMenu
が非表示になった直後に呼び出されます。public final ObservableList<MenuItem> getItems()
public void show()
ContextMenu
がまだ表示されていない場合は、ContextMenu
が表示されます。public void hide()
ContextMenu
(すでに表示されていた場合)と、表示中のすべてのサブメニューを非表示にします。このメニューが表示されていない場合は、この関数を起動しても何も行われません。public <E extends Event> void addEventHandler(EventType<E> eventType, EventHandler<E> eventHandler)
Event
を受け取ると呼び出されます。addEventHandler
、クラス: MenuItem
E
- ハンドラの特定のイベント・クラスeventType
- ハンドラが受け取るイベントのタイプeventHandler
- 登録するハンドラpublic <E extends Event> void removeEventHandler(EventType<E> eventType, EventHandler<E> eventHandler)
removeEventHandler
、クラス: MenuItem
E
- ハンドラの特定のイベント・クラスeventType
- 登録解除するイベント・タイプeventHandler
- 登録解除するハンドラpublic EventDispatchChain buildEventDispatchChain(EventDispatchChain tail)
EventTarget
を対象にしたイベントの処理に関係する可能性があるイベント・ディスパッチャが含まれます。このイベント・ターゲットはチェーンに自動的には追加されないため、これがイベントを処理する場合は、それ自体のEventDispatcher
をチェーンに追加する必要があります。
イベント・ターゲットが階層の一部である場合、そのチェーンは通常、階層のルートからイベント・ターゲットまでの収集されたイベント・ディスパッチャから作成されます。
イベント・ディスパッチ・チェーンは、提供される初期イベント・ディスパッチ・チェーンに対する変更によって構築されます。返されるチェーンでは初期チェーンが最後にある必要があるため、ディスパッチャは初期チェーンの前に追加される必要があります。
呼出し元は、初期チェーンが変更されないままであることや、返される値によって異なるチェーンが参照されることを想定できません。
buildEventDispatchChain
、インタフェース: EventTarget
buildEventDispatchChain
、クラス: MenuItem
tail
- 構築元となる初期チェーンCopyright (c) 2008, 2015, Oracle and/or its affiliates. All rights reserved.