Класс CustomMenuItem

java.lang.Object

javafx.scene.control.MenuItem

javafx.scene.control.CustomMenuItem

Все реализованные интерфейсы:: Styleable, EventTarget

Прямые известные подклассы:: SeparatorMenuItem

public class CustomMenuItem
extends MenuItem

Элемент меню (MenuItem), позволяющий встраивать произвольные узлы, назначив Node свойству content. CustomMenuItem пытается сделать произвольные узлы более естественными в меню. Например, при наведении курсора на узел (или перемещении с помощью клавиатуры или других альтернативных средств) автоматически отображается выделение при наведении.

Полезным свойством этого класса является hideOnClick. Этот булево параметр указывает, будет ли CustomMenuItem автоматически скрываться при щелчке пользователя внутри границ CustomMenuItem. Это особенно полезно, когда узел внутри CustomMenuItem представляет собой элемент управления, требующий взаимодействия пользователя, так как установка свойства hideOnClick в false позволяет пользователю взаимодействовать с ним, не скрывая меню. По умолчанию hideOnClick имеет значение true.

Пример использования CustomMenuItem показан ниже.

 CustomMenuItem customMenuItem = new CustomMenuItem(new Slider());
 customMenuItem.setHideOnClick(false);

 Menu menu = new Menu("Brightness");
 menu.getItems().add(customMenuItem);
 MenuBar menuBar = new MenuBar(menu);

Ползунок центрируется по горизонтали при отображении меню, и взаимодействие с ползунком не приведет к исчезновению меню.

C тех пор как:: JavaFX 2.0
См. также:: MenuItem, Menu

Краткое описание свойств

Свойства
Тип	Свойство	Описание
`ObjectProperty<Node>`	`content`	Узел для отображения в этом CustomMenuItem.
`BooleanProperty`	`hideOnClick`	Если true, этот пункт меню и все видимые меню будут скрыты при щелчке по этому пункту меню.

Свойства, объявленные в классе javafx.scene.control.MenuItem

accelerator, disable, graphic, id, mnemonicParsing, onAction, onMenuValidation, parentMenu, parentPopup, style, text, visible

Краткое описание полей

Поля, объявленные в классе javafx.scene.control.MenuItem

MENU_VALIDATION_EVENT

Краткое описание конструкторов

Конструкторы
Конструктор	Описание
`CustomMenuItem()`	Создает экземпляр по умолчанию CustomMenuItem.
`CustomMenuItem(Node node)`	Создает CustomMenuItem и инициализирует его содержимое заданным узлом.
`CustomMenuItem(Node node, boolean hideOnClick)`	Создает CustomMenuItem и устанавливает содержимое заданному узлу.

Краткое описание методов

Модификатор и тип	Метод	Описание
`ObjectProperty<Node>`	`contentProperty()`	Узел для отображения в этом CustomMenuItem.
`Node`	`getContent()`	Возвращает значение свойства content.
`BooleanProperty`	`hideOnClickProperty()`	Если true, этот пункт меню и все видимые меню будут скрыты при щелчке по этому пункту меню.
`boolean`	`isHideOnClick()`	Возвращает значение свойства hideOnClick.
`void`	`setContent(Node value)`	Устанавливает значение свойства content.
`void`	`setHideOnClick(boolean value)`	Устанавливает значение свойства hideOnClick.

Методы, объявленные в классе javafx.scene.control.MenuItem

acceleratorProperty, addEventHandler, disableProperty, fire, getAccelerator, getGraphic, getOnAction, getOnMenuValidation, getParentMenu, getParentPopup, getProperties, getPseudoClassStates, getStyleableParent, getText, getTypeSelector, getUserData, graphicProperty, idProperty, isDisable, isMnemonicParsing, isVisible, mnemonicParsingProperty, onActionProperty, onMenuValidationProperty, parentMenuProperty, parentPopupProperty, removeEventHandler, setAccelerator, setDisable, setGraphic, setId, setMnemonicParsing, setOnAction, setOnMenuValidation, setParentMenu, setParentPopup, setStyle, setText, setUserData, setVisible, styleProperty, textProperty, visibleProperty

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Методы, объявленные в интерфейсе javafx.event.EventTarget

buildEventDispatchChain

Методы, объявленные в интерфейсе javafx.css.Styleable

getCssMetaData, getId, getStyle, getStyleableNode, getStyleClass

Подробности свойства

content

public final ObjectProperty<Node> contentProperty

Узел для отображения внутри этого CustomMenuItem.

См. также:: getContent(), setContent(Node)

hideOnClick

public final BooleanProperty hideOnClickProperty

Если true, этот пункт меню и все видимые меню будут скрыты при нажатии на этот пункт меню.

Значение по умолчанию:: true
См. также:: isHideOnClick(), setHideOnClick(boolean)

Подробности конструктора

CustomMenuItem

public CustomMenuItem()

Создаёт экземпляр CustomMenuItem по умолчанию.

CustomMenuItem

public CustomMenuItem(Node node)

Создаёт CustomMenuItem и инициализирует его содержимое указанным узлом.

Параметры:: node - для встраивания внутри этого CustomMenuItem

CustomMenuItem

public CustomMenuItem(Node node, boolean hideOnClick)

Создаёт CustomMenuItem и устанавливает содержимое в указанный узел.

Параметры:: node - для встраивания внутри этого CustomMenuItem; hideOnClick - если false, меню не будет скрываться при взаимодействии пользователя с узлом.

Подробности метода

setContent

public final void setContent(Node value)

Устанавливает значение свойства content.

Описание свойства:: Узел для отображения внутри этого CustomMenuItem.

getContent

public final Node getContent()

Получает значение свойства content.

Описание свойства:: Узел для отображения внутри этого CustomMenuItem.

contentProperty

public final ObjectProperty<Node> contentProperty()

Узел для отображения внутри этого CustomMenuItem.

См. также:: getContent(), setContent(Node)

setHideOnClick

public final void setHideOnClick(boolean value)

Устанавливает значение свойства hideOnClick.

Описание свойства:: Если true, этот пункт меню и все видимые меню будут скрыты при нажатии на этот пункт меню.
Значение по умолчанию:: true

isHideOnClick

public final boolean isHideOnClick()

Получает значение свойства hideOnClick.

Описание свойства:: Если true, этот пункт меню и все видимые меню будут скрыты при нажатии на этот пункт меню.
Значение по умолчанию:: true

hideOnClickProperty

public final BooleanProperty hideOnClickProperty()

Если true, этот пункт меню и все видимые меню будут скрыты при нажатии на этот пункт меню.

Значение по умолчанию:: true
См. также:: isHideOnClick(), setHideOnClick(boolean)

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.