A MenuBar control traditionally is placed at the very top of the user interface, and embedded within it are Menus. To add a menu to a menubar, you add it to the menus ObservableList. By default, for each menu added to the menubar, it will be represented as a button with the Menu text value displayed.

MenuBar sets focusTraversable to false.

To create and populate a MenuBar, you may do what is shown below. Please refer to the Menu API page for more information on how to configure it.

 Menu menu1 = new Menu("File");
Menu menu2 = new Menu("Options");
Menu menu3 = new Menu("Help");

MenuBar menuBar = new MenuBar(menu1, menu2, menu3);

Modifier and Type	Class and Description
private static class	MenuBar.StyleableProperties

Modifier and Type	Field and Description
private String	BIND_MSG
private static final String	DEFAULT_STYLE_CLASS
private ObservableList<Menu>	menus
private BooleanProperty	useSystemMenuBar

Constructor Summary

Access	Constructor and Description
public	MenuBar() Creates a new empty MenuBar.
public	MenuBar(Menu... The menus to place inside the MenuBar menus) Creates a new MenuBar populated with the given menus.

Method Summary

Modifier and Type	Method and Description
protected Skin<?>	createDefaultSkin() Overrides javafx.scene.control.Control.createDefaultSkin. Create a new instance of the default skin for this control.
public static List<CssMetaData<? extends Styleable, ?>>	Returns: the `CssMetaData` getClassCssMetaData() Hides javafx.scene.control.Control.getClassCssMetaData. Gets the `CssMetaData` associated with this class, which may include the `CssMetaData` of its superclasses.
public List<CssMetaData<? extends Styleable, ?>>	getControlCssMetaData() Overrides javafx.scene.control.Control.getControlCssMetaData. Gets the unmodifiable list of the control's CSS-styleable properties.
protected Boolean	getInitialFocusTraversable() Overrides javafx.scene.control.Control.getInitialFocusTraversable. Returns the initial focus traversable state of this control, for use by the JavaFX CSS engine to correctly set its initial value.
public final ObservableList<Menu>	Returns: the list of menus to show within this MenuBar getMenus() The menus to show within this MenuBar.
public final boolean	isUseSystemMenuBar()
public final void	setUseSystemMenuBar(boolean value)
public final BooleanProperty	Returns: the use system menu bar property useSystemMenuBarProperty() Use the system menu bar if the current platform supports it.

Field Detail

BIND_MSG	back to summary
private String BIND_MSG

DEFAULT_STYLE_CLASS	back to summary
private static final String DEFAULT_STYLE_CLASS

menus	back to summary
private ObservableList<Menu> menus

useSystemMenuBar	back to summary
private BooleanProperty useSystemMenuBar

Constructor Detail

MenuBar	back to summary
public MenuBar() Creates a new empty MenuBar.

MenuBar	back to summary
public MenuBar(Menu... menus) Creates a new MenuBar populated with the given menus. Parameters menus:Menu[] The menus to place inside the MenuBar Since JavaFX 8u40

Method Detail

createDefaultSkin back to summary

createDefaultSkin	back to summary
protected Skin<?> createDefaultSkin() Overrides javafx.scene.control.Control.createDefaultSkin. Doc from javafx.scene.control.Control.createDefaultSkin. Create a new instance of the default skin for this control. This is called to create a skin for the control if no skin is provided via CSS `-fx-skin` or set explicitly in a sub-class with `setSkin(...)`. Returns:Skin<?> new instance of default skin for this control. If null then the control will have no skin unless one is provided by css. Annotations @Override

protected Skin<?> createDefaultSkin()

Overrides javafx.scene.control.Control.createDefaultSkin.

Doc from javafx.scene.control.Control.createDefaultSkin.

Create a new instance of the default skin for this control. This is called to create a skin for the control if no skin is provided via CSS -fx-skin or set explicitly in a sub-class with setSkin(...).

Returns:Skin<?>

new instance of default skin for this control. If null then the control will have no skin unless one is provided by css.

Annotations

@Override

getClassCssMetaData back to summary

public static List<CssMetaData<? extends Styleable, ?>> getClassCssMetaData()

Hides javafx.scene.control.Control.getClassCssMetaData.

Gets the CssMetaData associated with this class, which may include the CssMetaData of its superclasses.

Returns:List<CssMetaData<? extends Styleable, ?>>: the CssMetaData
Since: JavaFX 8.0

getControlCssMetaData

back to summary

public List<CssMetaData<? extends Styleable, ?>> getControlCssMetaData()

Overrides javafx.scene.control.Control.getControlCssMetaData.

Doc from javafx.scene.control.Control.getControlCssMetaData.

Gets the unmodifiable list of the control's CSS-styleable properties.

Returns:List<CssMetaData<? extends Styleable, ?>>

the unmodifiable list of the control's CSS-styleable properties

Annotations

@Override

Since

JavaFX 8.0

getInitialFocusTraversable	back to summary
protected Boolean getInitialFocusTraversable() Overrides javafx.scene.control.Control.getInitialFocusTraversable. Returns the initial focus traversable state of this control, for use by the JavaFX CSS engine to correctly set its initial value. This method is overridden as by default UI controls have focus traversable set to true, but that is not appropriate for this control. Returns:Boolean Doc from javafx.scene.control.Control.getInitialFocusTraversable. the initial focus traversable state of this control Annotations @Override Since 9

getInitialFocusTraversable

back to summary

protected Boolean getInitialFocusTraversable()

Overrides javafx.scene.control.Control.getInitialFocusTraversable.

Returns the initial focus traversable state of this control, for use by the JavaFX CSS engine to correctly set its initial value. This method is overridden as by default UI controls have focus traversable set to true, but that is not appropriate for this control.

Returns:Boolean

Doc from javafx.scene.control.Control.getInitialFocusTraversable.

the initial focus traversable state of this control

Annotations

@Override

Since

getMenus back to summary

getMenus	back to summary
public final ObservableList<Menu> getMenus() The menus to show within this MenuBar. If this ObservableList is modified at runtime, the MenuBar will update as expected. Returns:ObservableList<Menu> the list of menus to show within this MenuBar See Also `Menu`

public final ObservableList<Menu> getMenus()

The menus to show within this MenuBar. If this ObservableList is modified at runtime, the MenuBar will update as expected.

Returns:ObservableList<Menu>: the list of menus to show within this MenuBar
See Also: Menu

isUseSystemMenuBar	back to summary
public final boolean isUseSystemMenuBar()

setUseSystemMenuBar	back to summary
public final void setUseSystemMenuBar(boolean value)

useSystemMenuBarProperty	back to summary
public final BooleanProperty useSystemMenuBarProperty() Use the system menu bar if the current platform supports it. This should not be set on more than one MenuBar instance per Stage. If this property is set to true on more than one MenuBar in the same Stage, then the last menu set is allowed to modify the system menu bar, and if there is an existing installed system menu it is unset and removed from the system menu bar. Note that trying to uni-directionally bind to this property will throw a RuntimeException. Please use bi-directional binding to this property instead. Returns:BooleanProperty the use system menu bar property Since JavaFX 2.1

useSystemMenuBarProperty

back to summary

public final BooleanProperty useSystemMenuBarProperty()

Use the system menu bar if the current platform supports it. This should not be set on more than one MenuBar instance per Stage. If this property is set to true on more than one MenuBar in the same Stage, then the last menu set is allowed to modify the system menu bar, and if there is an existing installed system menu it is unset and removed from the system menu bar. Note that trying to uni-directionally bind to this property will throw a RuntimeException. Please use bi-directional binding to this property instead.

Returns:BooleanProperty: the use system menu bar property
Since: JavaFX 2.1

javafx.scene.control back to summary

private Class MenuBar.StyleableProperties

Class Inheritance

extends Object

java.lang.Object
javafx.scene.control.MenuBar.StyleableProperties

Field Summary

Modifier and Type	Field and Description
private static final List<CssMetaData<? extends Styleable, ?>>	STYLEABLES
private static final CssMetaData<MenuBar, Boolean>	USE_SYSTEM_MENU_BAR

Constructor Summary

Access	Constructor and Description
private	StyleableProperties()

Method Summary

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

STYLEABLES	back to summary
private static final List<CssMetaData<? extends Styleable, ?>> STYLEABLES

USE_SYSTEM_MENU_BAR	back to summary
private static final CssMetaData<MenuBar, Boolean> USE_SYSTEM_MENU_BAR

Constructor Detail

StyleableProperties	back to summary
private StyleableProperties()

public Class MenuBar

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class MenuBar.StyleableProperties

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail