- java.lang.Object
-
- javafx.scene.control.MenuItem
-
- javafx.scene.control.Menu
-
- すべての実装されたインタフェース:
Styleable
,EventTarget
@DefaultProperty("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
が現在表示されているかどうかを示します。-
クラス 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
-
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 具象メソッド 修飾子と型 メソッド 説明 <E extends Event>
voidaddEventHandler(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>
voidremoveEventHandler(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, getStyleableNode, 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
-
-
-
-
プロパティの詳細
-
showing
public final ReadOnlyBooleanProperty showingProperty
ContextMenu
が現在表示されているかどうかを示します。- デフォルト値:
- false
- 関連項目:
isShowing()
-
onShowing
public final ObjectProperty<EventHandler<Event>> onShowingProperty
メニューに表示するアイテムがない場合でも、ContextMenu
が表示される直前に呼び出されます。 ただし、メニューに有効なアンカー・ノードがない場合には呼び出されないことに注意してください。
-
onShown
public final ObjectProperty<EventHandler<Event>> onShownProperty
ContextMenu
が表示された直後に呼び出されます。
-
onHiding
public final ObjectProperty<EventHandler<Event>> onHidingProperty
ContextMenu
が非表示になる直前に呼び出されます。
-
onHidden
public final ObjectProperty<EventHandler<Event>> onHiddenProperty
ContextMenu
が非表示になった直後に呼び出されます。
-
-
フィールドの詳細
-
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が空の場合は呼び出されません。
-
-
コンストラクタの詳細
-
Menu
public Menu()
表示テキストを空の文字列にしてメニューを構築します。- 導入されたバージョン:
- JavaFX 2.2
-
Menu
public Menu(String text)
メニューを構築し、指定されたテキストで表示テキストを設定します。- パラメータ:
text
- メニュー・ボタンに表示するテキスト
-
Menu
public Menu(String text, Node graphic)
メニューを構築し、指定されたテキストで表示テキストを設定し、グラフィックNode
を指定されたノードに設定します。- パラメータ:
text
- メニュー・ボタンに表示するテキストgraphic
- メニュー・ボタンに表示するグラフィック
-
-
メソッドの詳細
-
isShowing
public final boolean isShowing()
プロパティshowingの値を取得します。- プロパティの説明:
ContextMenu
が現在表示されているかどうかを示します。- デフォルト値:
- false
-
showingProperty
public final ReadOnlyBooleanProperty showingProperty()
ContextMenu
が現在表示されているかどうかを示します。- デフォルト値:
- false
- 関連項目:
isShowing()
-
onShowingProperty
public final ObjectProperty<EventHandler<Event>> onShowingProperty()
メニューに表示するアイテムがない場合でも、ContextMenu
が表示される直前に呼び出されます。 ただし、メニューに有効なアンカー・ノードがない場合には呼び出されないことに注意してください。
-
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
が表示された直後に呼び出されます。
-
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
が非表示になる直前に呼び出されます。
-
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
が非表示になった直後に呼び出されます。
-
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
- 構築元となる初期チェーン- 戻り値:
- このターゲットの結果のイベント・ディスパッチ・チェーン
-
-