```
public class Menu
extends MenuItem
```
A popup menu of actionable items which is displayed to the user only upon request. When a menu is visible, in most use cases, the user can select one menu item before the menu goes back to its hidden state. This means the menu is a good place to put important functionality that does not necessarily need to be visible at all times to the user.
Menus are typically placed in a MenuBar, or as a submenu of another Menu. If the intention is to offer a context menu when the user right-clicks in a certain area of their user interface, then this is the wrong control to use. This is because when Menu is added to the scenegraph, it has a visual representation that will result in it appearing on screen. Instead, ContextMenu should be used in this circumstance.
Creating a Menu and inserting it into a MenuBar is easy, as shown below:
```
 final Menu menu1 = new Menu("File");
 MenuBar menuBar = new MenuBar();
 menuBar.getMenus().add(menu1);
 
```
A Menu is a subclass of MenuItem which means that it can be inserted into a Menu's items ObservableList, resulting in a submenu being created:
```
 MenuItem menu12 = new MenuItem("Open");
 menu1.getItems().add(menu12);
 
```
The items ObservableList allows for any MenuItem type to be inserted, including its subclasses Menu, MenuItem, RadioMenuItem, CheckMenuItem, CustomMenuItem and SeparatorMenuItem. In order to insert an arbitrary Node to a Menu, a CustomMenuItem can be used. One exception to this general rule is that SeparatorMenuItem could be used for inserting a separator.
Since:

JavaFX 2.0

See Also:

MenuBar, MenuItem

Property Summary

All Methods Instance Methods Concrete Methods
Type	Property and Description
`<any>`	`onHidden` Called just after the `ContextMenu` has been hidden.
`<any>`	`onHiding` Called just prior to the `ContextMenu` being hidden.
`<any>`	`onShowing` Called just prior to the `ContextMenu` being shown, even if the menu has no items to show.
`<any>`	`onShown` Called just after the `ContextMenu` is shown.
`ReadOnlyBooleanProperty`	`showing` Indicates whether the `ContextMenu` is currently visible.

Properties inherited from class javafx.scene.control.MenuItem
acceleratorProperty, disableProperty, graphicProperty, idProperty, mnemonicParsingProperty, onActionProperty, onMenuValidationProperty, parentMenuProperty, parentPopupProperty, styleProperty, textProperty, visibleProperty

Field Summary

Fields
Modifier and Type	Field and Description
`private static java.lang.String`	`DEFAULT_STYLE_CLASS` * Stylesheet Handling * *
`private <any>`	`items` * Instance variables * *
`static <any>`	`ON_HIDDEN` Called when the contextMenu for this menu is hidden.
`static <any>`	`ON_HIDING` Called when the contextMenu for this menu will be hidden.
`static <any>`	`ON_SHOWING` Called when the contextMenu for this menu will be shown.
`static <any>`	`ON_SHOWN` Called when the contextMenu for this menu shows.
`private <any>`	`onHidden`
`private <any>`	`onHiding`
`private <any>`	`onShowing`
`private <any>`	`onShown`
`private ReadOnlyBooleanWrapper`	`showing` Indicates whether the `ContextMenu` is currently visible.
`private static java.lang.String`	`STYLE_CLASS_SHOWING`

Fields inherited from class javafx.scene.control.MenuItem
eventHandlerManager, MENU_VALIDATION_EVENT

Constructor Summary

Constructors
Constructor and Description
`Menu()` Constructs a Menu with an empty string for its display text.
`Menu(java.lang.String text)` Constructs a Menu and sets the display text with the specified text.
`Menu(java.lang.String text, Node graphic)` Constructs a Menu and sets the display text with the specified text and sets the graphic `Node` to the given node.
`Menu(java.lang.String text, Node graphic, MenuItem... items)` Constructs a Menu and sets the display text with the specified text, the graphic `Node` to the given node, and inserts the given items into the `items` list.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`<E extends Event> void`	`addEventHandler(<any> eventType, <any> eventHandler)` Registers an event handler to this MenuItem.
`EventDispatchChain`	`buildEventDispatchChain(EventDispatchChain tail)`
`<any>`	`getItems()` The items to show within this menu.
`<any>`	`getOnHidden()` Gets the value of the property onHidden.
`<any>`	`getOnHiding()` Gets the value of the property onHiding.
`<any>`	`getOnShowing()` Gets the value of the property onShowing.
`<any>`	`getOnShown()` Gets the value of the property onShown.
`void`	`hide()` Hides the `ContextMenu` if it was previously showing, and any showing submenus.
`boolean`	`isShowing()` Gets the value of the property showing.
`<any>`	`onHiddenProperty()` Called just after the `ContextMenu` has been hidden.
`<any>`	`onHidingProperty()` Called just prior to the `ContextMenu` being hidden.
`<any>`	`onShowingProperty()` Called just prior to the `ContextMenu` being shown, even if the menu has no items to show.
`<any>`	`onShownProperty()` Called just after the `ContextMenu` is shown.
`<E extends Event> void`	`removeEventHandler(<any> eventType, <any> eventHandler)` Unregisters a previously registered event handler from this MenuItem.
`void`	`setOnHidden(<any> value)` Sets the value of the property onHidden.
`void`	`setOnHiding(<any> value)` Sets the value of the property onHiding.
`void`	`setOnShowing(<any> value)` Sets the value of the property onShowing.
`void`	`setOnShown(<any> value)` Sets the value of the property onShown.
`private void`	`setShowing(boolean value)`
`void`	`show()` If the Menu is not disabled and the `ContextMenu` is not already showing, then this will cause the `ContextMenu` to be shown.
`ReadOnlyBooleanProperty`	`showingProperty()` Indicates whether the `ContextMenu` is currently visible.
`private ReadOnlyBooleanWrapper`	`showingPropertyImpl()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Property Detail
  - showing
```
public final ReadOnlyBooleanProperty showingProperty
```
    Indicates whether the ContextMenu is currently visible.
    
    See Also:
    
    isShowing()
  - onShowing
```
public final <any> onShowingProperty
```
    Called just prior to the ContextMenu being shown, even if the menu has no items to show. Note however that this won't be called if the menu does not have a valid anchor node.
    
    See Also:
    
    getOnShowing(), #setOnShowing()
  - onShown
```
public final <any> onShownProperty
```
    Called just after the ContextMenu is shown.
    
    See Also:
    
    getOnShown(), #setOnShown()
  - onHiding
```
public final <any> onHidingProperty
```
    Called just prior to the ContextMenu being hidden.
    
    See Also:
    
    getOnHiding(), #setOnHiding()
  - onHidden
```
public final <any> onHiddenProperty
```
    Called just after the ContextMenu has been hidden.
    
    See Also:
    
    getOnHidden(), #setOnHidden()
- Field Detail
  - ON_SHOWING
```
public static final <any> ON_SHOWING
```
    Called when the contextMenu for this menu will be shown. However if the contextMenu is empty then this will not be called.
  - ON_SHOWN
```
public static final <any> ON_SHOWN
```
    Called when the contextMenu for this menu shows. However if the contextMenu is empty then this will not be called.
  - ON_HIDING
```
public static final <any> ON_HIDING
```
    Called when the contextMenu for this menu will be hidden. However if the contextMenu is empty then this will not be called.
  - ON_HIDDEN
```
public static final <any> ON_HIDDEN
```
    Called when the contextMenu for this menu is hidden. However if the contextMenu is empty then this will not be called.
  - showing
```
private ReadOnlyBooleanWrapper showing
```
    Indicates whether the ContextMenu is currently visible.
  - onShowing
```
private <any> onShowing
```
  - onShown
```
private <any> onShown
```
  - onHiding
```
private <any> onHiding
```
  - onHidden
```
private <any> onHidden
```
  - items
```
private final <any> items
```
    * Instance variables * *
  - DEFAULT_STYLE_CLASS
```
private static final java.lang.String DEFAULT_STYLE_CLASS
```
    * Stylesheet Handling * *
    
    See Also:
    
    Constant Field Values
  - STYLE_CLASS_SHOWING
```
private static final java.lang.String STYLE_CLASS_SHOWING
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - Menu
```
public Menu()
```
    Constructs a Menu with an empty string for its display text.
    
    Since:
    
    JavaFX 2.2
  - Menu
```
public Menu(java.lang.String text)
```
    Constructs a Menu and sets the display text with the specified text.
    
    Parameters:
    
    text - the text to display on the menu button
  - Menu
```
public Menu(java.lang.String text,
            Node graphic)
```
    Constructs a Menu and sets the display text with the specified text and sets the graphic Node to the given node.
    
    Parameters:
    
    text - the text to display on the menu button
    
    graphic - the graphic to display on the menu button
  - Menu
```
public Menu(java.lang.String text,
            Node graphic,
            MenuItem... items)
```
    Constructs a Menu and sets the display text with the specified text, the graphic Node to the given node, and inserts the given items into the items list.
    
    Parameters:
    
    text - the text to display on the menu button
    
    graphic - the graphic to display on the menu button
    
    items - The items to display in the popup menu.
    
    Since:
    
    JavaFX 8u40
- Method Detail
  - setShowing
```
private void setShowing(boolean value)
```
  - isShowing
```
public final boolean isShowing()
```
    Gets the value of the property showing.
  - showingProperty
```
public final ReadOnlyBooleanProperty showingProperty()
```
    Indicates whether the ContextMenu is currently visible.
    
    See Also:
    
    isShowing()
  - showingPropertyImpl
```
private ReadOnlyBooleanWrapper showingPropertyImpl()
```
  - onShowingProperty
```
public final <any> onShowingProperty()
```
    Called just prior to the ContextMenu being shown, even if the menu has no items to show. Note however that this won't be called if the menu does not have a valid anchor node.
    
    See Also:
    
    getOnShowing(), #setOnShowing()
  - setOnShowing
```
public final void setOnShowing(<any> value)
```
    Sets the value of the property onShowing.
  - getOnShowing
```
public final <any> getOnShowing()
```
    Gets the value of the property onShowing.
  - onShownProperty
```
public final <any> onShownProperty()
```
    Called just after the ContextMenu is shown.
    
    See Also:
    
    getOnShown(), #setOnShown()
  - setOnShown
```
public final void setOnShown(<any> value)
```
    Sets the value of the property onShown.
  - getOnShown
```
public final <any> getOnShown()
```
    Gets the value of the property onShown.
  - onHidingProperty
```
public final <any> onHidingProperty()
```
    Called just prior to the ContextMenu being hidden.
    
    See Also:
    
    getOnHiding(), #setOnHiding()
  - setOnHiding
```
public final void setOnHiding(<any> value)
```
    Sets the value of the property onHiding.
  - getOnHiding
```
public final <any> getOnHiding()
```
    Gets the value of the property onHiding.
  - onHiddenProperty
```
public final <any> onHiddenProperty()
```
    Called just after the ContextMenu has been hidden.
    
    See Also:
    
    getOnHidden(), #setOnHidden()
  - setOnHidden
```
public final void setOnHidden(<any> value)
```
    Sets the value of the property onHidden.
  - getOnHidden
```
public final <any> getOnHidden()
```
    Gets the value of the property onHidden.
  - getItems
```
public final <any> getItems()
```
    The items to show within this menu. If this ObservableList is modified at runtime, the Menu will update as expected.
    
    Returns:
    
    the list of items
  - show
```
public void show()
```
    If the Menu is not disabled and the ContextMenu is not already showing, then this will cause the ContextMenu to be shown.
  - hide
```
public void hide()
```
    Hides the ContextMenu if it was previously showing, and any showing submenus. If this menu is not showing, then invoking this function has no effect.
  - addEventHandler
```
public <E extends Event> void addEventHandler(<any> eventType,
                                              <any> eventHandler)
```
    Registers an event handler to this MenuItem. The handler is called when the menu item receives an Event of the specified type during the bubbling phase of event delivery.
    
    Overrides:
    
    addEventHandler in class MenuItem
    
    Type Parameters:
    
    E - the specific event class of the handler
    
    Parameters:
    
    eventType - the type of the events to receive by the handler
    
    eventHandler - the handler to register
  - removeEventHandler
```
public <E extends Event> void removeEventHandler(<any> eventType,
                                                 <any> eventHandler)
```
    Unregisters a previously registered event handler from this MenuItem. One handler might have been registered for different event types, so the caller needs to specify the particular event type from which to unregister the handler.
    
    Overrides:
    
    removeEventHandler in class MenuItem
    
    Type Parameters:
    
    E - the specific event class of the handler
    
    Parameters:
    
    eventType - the event type from which to unregister
    
    eventHandler - the handler to unregister
  - buildEventDispatchChain
```
public EventDispatchChain buildEventDispatchChain(EventDispatchChain tail)
```
    Overrides:
    
    buildEventDispatchChain in class MenuItem

Class Menu

Property Summary

Properties inherited from class javafx.scene.control.MenuItem

Field Summary

Fields inherited from class javafx.scene.control.MenuItem

Constructor Summary

Method Summary

Methods inherited from class javafx.scene.control.MenuItem

Methods inherited from class java.lang.Object

Property Detail

showing

onShowing

onShown

onHiding

onHidden

Field Detail

ON_SHOWING

ON_SHOWN

ON_HIDING

ON_HIDDEN

showing

onShowing

onShown

onHiding

onHidden

items

DEFAULT_STYLE_CLASS

STYLE_CLASS_SHOWING

Constructor Detail

Menu

Menu

Menu

Menu

Method Detail

setShowing

isShowing

showingProperty

showingPropertyImpl

onShowingProperty

setOnShowing

getOnShowing

onShownProperty

setOnShown

getOnShown

onHidingProperty

setOnHiding

getOnHiding

onHiddenProperty

setOnHidden

getOnHidden

getItems

show

hide

addEventHandler

removeEventHandler

buildEventDispatchChain