Класс 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);

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

С момента:

JavaFX 2.0

См. также:

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

Тип	Свойство	Описание
`final ObjectProperty<Node>`	`content`	Узел для отображения в этом CustomMenuItem.
`final 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 и устанавливает содержимое указанным узлом.

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

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

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

acceleratorProperty, buildEventDispatchChain, 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, visibleProperty

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

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

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

addEventFilter, addEventHandler, removeEventFilter, removeEventHandler

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

getStyleableNode

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

content

public final ObjectProperty<Node> contentProperty

Узел, который должен отображаться в этом элементе меню CustomMenuItem.

См. также:

getContent()
setContent(Node)
contentProperty()

hideOnClick

public final BooleanProperty hideOnClickProperty

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

Значение по умолчанию:

true

См. также:

isHideOnClick()
setHideOnClick(boolean)
hideOnClickProperty()

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

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.

Параметры:

value - значение для свойства content

См. также:

getContent()
contentProperty()

getContent

public final Node getContent()

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

Описание свойства:

Узел, который должен отображаться в этом элементе меню CustomMenuItem.

Возвращает:

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

См. также:

setContent(Node)
contentProperty()

contentProperty

public final ObjectProperty<Node> contentProperty()

Узел, который должен отображаться в этом элементе меню CustomMenuItem.

Возвращает:

свойство content

См. также:

getContent()
setContent(Node)

setHideOnClick

public final void setHideOnClick(boolean value)

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

Описание свойства:

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

Значение по умолчанию:

true

Параметры:

value - значение для свойства hideOnClick

См. также:

isHideOnClick()
hideOnClickProperty()

isHideOnClick

public final boolean isHideOnClick()

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

Описание свойства:

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

Значение по умолчанию:

true

Возвращает:

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

См. также:

setHideOnClick(boolean)
hideOnClickProperty()

hideOnClickProperty

public final BooleanProperty hideOnClickProperty()

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

Значение по умолчанию:

true

Возвращает:

свойство hideOnClick

См. также:

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.