Класс MenuItem
- Все реализованные интерфейсы:
-
Styleable,EventTarget
- Прямые известные подклассы:
-
CheckMenuItem,CustomMenuItem,Menu,RadioMenuItem
@IDProperty("id") public class MenuItem extends Object implements EventTarget, Styleable MenuItem предназначен для использования совместно с Menu для предоставления пользователям опций. MenuItem служит базовым классом для большей части API меню JavaFX. Он имеет свойство отображения text, а также необязательный узел graphic, который может быть на нём установлен. Свойство accelerator позволяет получить доступ к связанному действию одним нажатием клавиши. Также, как и в случае с элементом управления Button, используя метод setOnAction(javafx.event.EventHandler<javafx.event.ActionEvent>), вы можете заставить экземпляр MenuItem выполнить любое действие по вашему желанию.
Примечание: Хотя в MenuItem может быть вставлен графический элемент любого размера, наиболее распространённый размер в большинстве приложений — 16x16 пикселей. Это рекомендуемые размеры графического элемента, если вы используете стандартную стилизацию JavaFX.
Создание MenuItem просто:
MenuItem menuItem = new MenuItem("Open");
menuItem.setOnAction(e -> System.out.println("Opening Database Connection..."));
Circle graphic = new Circle(8);
graphic.setFill(Color.GREEN);
menuItem.setGraphic(graphic);
Menu menu = new Menu("File");
menu.getItems().add(menuItem);
MenuBar menuBar = new MenuBar(menu); - С:
- JavaFX 2.0
- См. также:
Краткое описание свойств
| Тип | Свойство | Описание |
|---|---|---|
final ObjectProperty |
accelerator |
Свойство ускорителя обеспечивает доступ к связанному действию одним нажатием клавиши. |
final BooleanProperty |
disable |
Устанавливает индивидуальное состояние отключения для этого MenuItem. |
final ObjectProperty |
graphic |
Необязательный графический элемент для MenuItem. |
final StringProperty |
id |
Идентификатор этого MenuItem. |
final BooleanProperty |
mnemonicParsing |
Свойство mnemonicParsing для включения/отключения разбора текста. |
final ObjectProperty |
onAction |
Действие, которое вызывается при каждом срабатывании MenuItem. |
final ObjectProperty |
onMenuValidation |
Обработчик событий, связанный с вызовом ускорителя для MenuItem. |
final ReadOnlyObjectProperty |
parentMenu |
Это Menu, в котором существует этот MenuItem. |
final ReadOnlyObjectProperty |
parentPopup |
Это ContextMenu, в котором существует этот MenuItem. |
final StringProperty |
style |
Строковое представление CSS-стиля, связанного с данным MenuItem. |
final StringProperty |
text |
Текст для отображения в MenuItem. |
final BooleanProperty |
visible |
Указывает, должен ли этот MenuItem отображаться в графическом дереве. |
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
static final EventType |
MENU_VALIDATION_EVENT |
Вызывается при вызове ускорителя для MenuItem |
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
MenuItem() |
Создаёт MenuItem без текста отображения. |
MenuItem |
Создаёт MenuItem и устанавливает текст отображения с указанным текстом |
MenuItem |
Конструктор MenuItem и устанавливает текст отображения с указанным текстом и устанавливает графический элемент Node на заданный узел. |
Краткое описание методов
| Modifier and Type | Method | Description |
|---|---|---|
final ObjectProperty |
acceleratorProperty() |
Свойство ускорителя позволяет получить доступ к связанному действию одним нажатием клавиши. |
EventDispatchChain |
buildEventDispatchChain |
Создаёт цепочку обработки событий для этого целевого объекта. |
final BooleanProperty |
disableProperty() |
Устанавливает состояние отключения для данного элемента меню. |
void |
fire() |
Генерирует новое событие ActionEvent. |
final KeyCombination |
getAccelerator() |
Получает значение свойства accelerator. |
List |
getCssMetaData() |
CssMetaData для этого элемента с изменяемым стилем. |
final Node |
getGraphic() |
Получает значение свойства graphic. |
final String |
getId() |
Получает значение свойства id. |
final EventHandler |
getOnAction() |
Получает значение свойства onAction. |
final EventHandler |
getOnMenuValidation() |
Получает значение свойства onMenuValidation. |
final Menu |
getParentMenu() |
Получает значение свойства parentMenu. |
final ContextMenu |
getParentPopup() |
Получает значение свойства parentPopup. |
ObservableMap |
getProperties() |
Возвращает наблюдаемую карту свойств этого элемента меню, предназначенную в первую очередь для разработчиков приложений. |
final ObservableSet |
getPseudoClassStates() |
Возвращает состояние псевдокласса для этого элемента с изменяемым стилем. |
final String |
getStyle() |
Получает значение свойства style. |
Styleable |
getStyleableParent() |
Возвращает родителя этого элемента с изменяемым стилем или null, если родитель отсутствует. |
ObservableList |
getStyleClass() |
Список идентификаторов строк, которые могут использоваться для логической группировки узлов, в частности для внешнего движка стилей. |
final String |
getText() |
Получает значение свойства text. |
String |
getTypeSelector() |
Тип этого Styleable, используемый для сопоставления селекторов. |
Object |
getUserData() |
Возвращает Object, установленное методом setUserData(Object), или null, если объект не был установлен. |
final ObjectProperty |
graphicProperty() |
Необязательная графика для MenuItem. |
final StringProperty |
idProperty() |
Идентификатор этого элемента меню. |
final boolean |
isDisable() |
Получает значение свойства disable. |
final boolean |
isMnemonicParsing() |
Получает значение свойства mnemonicParsing. |
final boolean |
isVisible() |
Получает значение свойства visible. |
final BooleanProperty |
mnemonicParsingProperty() |
Свойство MnemonicParsing для включения/выключения синтаксического разбора текста. |
final ObjectProperty |
onActionProperty() |
Действие, которое вызывается при срабатывании элемента меню. |
final ObjectProperty |
onMenuValidationProperty() |
Обработчик событий, связанный с вызовом ускорителя для элемента меню. |
final ReadOnlyObjectProperty |
parentMenuProperty() |
Это Menu, в котором существует этот MenuItem. |
final ReadOnlyObjectProperty |
parentPopupProperty() |
Это ContextMenu, в котором существует этот MenuItem. |
final void |
setAccelerator |
Устанавливает значение свойства accelerator. |
final void |
setDisable |
Устанавливает значение свойства disable. |
final void |
setGraphic |
Устанавливает значение свойства graphic. |
final void |
setId |
Устанавливает значение свойства id. |
final void |
setMnemonicParsing |
Устанавливает значение свойства mnemonicParsing. |
final void |
setOnAction |
Устанавливает значение свойства onAction. |
final void |
setOnMenuValidation |
Устанавливает значение свойства onMenuValidation. |
protected final void |
setParentMenu |
Устанавливает значение свойства parentMenu. |
protected final void |
setParentPopup |
Устанавливает значение свойства parentPopup. |
final void |
setStyle |
Устанавливает значение свойства style. |
final void |
setText |
Устанавливает значение свойства text. |
void |
setUserData |
Сохраняет пользовательский объект, содержащий данные по своему усмотрению. |
final void |
setVisible |
Устанавливает значение свойства visible. |
final StringProperty |
styleProperty() |
Строковое представление CSS-стиля, связанного с этим конкретным элементом меню. |
final StringProperty |
textProperty() |
Текст для отображения в MenuItem. |
final BooleanProperty |
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
Подробности свойств
id
public final StringProperty idProperty
- См. также:
style
public final StringProperty styleProperty
- См. также:
parentMenu
public final ReadOnlyObjectProperty<Menu> parentMenuProperty
Menu, в котором существует этот MenuItem. Возможно, что у экземпляра этого класса нет parentMenu - это означает, что этот экземпляр либо: - Еще не связан со своим
parentMenu. - «Корневой»
Menu(т.е. это контекстное меню, прикрепленное непосредственно кMenuBar,MenuButtonили любому другому элементу управления, использующемуMenuвнутри).
- См. также:
parentPopup
public final ReadOnlyObjectProperty<ContextMenu> parentPopupProperty
ContextMenu, в котором существует этот MenuItem.- См. также:
text
public final StringProperty textProperty
MenuItem.- См. также:
graphic
public final ObjectProperty<Node> graphicProperty
MenuItem. Обычно это узел ImageView, но это не обязательно.- См. также:
onAction
public final ObjectProperty<EventHandler<ActionEvent>> onActionProperty
fire() разработчиком программы.- См. также:
onMenuValidation
public final ObjectProperty<EventHandler<Event>> onMenuValidationProperty
- С:
- JavaFX 2.2
- См. также:
disable
public final BooleanProperty disableProperty
- См. также:
visible
public final BooleanProperty visibleProperty
- См. также:
accelerator
public final ObjectProperty<KeyCombination> acceleratorProperty
- См. также:
mnemonicParsing
public final BooleanProperty mnemonicParsingProperty
По умолчанию для MenuItem значение равно true.
- См. также:
Подробности полей
MENU_VALIDATION_EVENT
public static final EventType<Event> MENU_VALIDATION_EVENT
Вызывается при вызове ускорителя для элемента меню
- С:
- JavaFX 2.2
Подробности конструкторов
MenuItem
public MenuItem()
MenuItem
public MenuItem(String text)
- Параметры:
-
text- текст для отображения - См. также:
MenuItem
public MenuItem(String text, Node graphic)
Node в указанный узел.- Параметры:
-
text- текст для отображения -
graphic- узел графического элемента - См. также:
Подробности методов
setId
public final void setId(String value)
id.- Описание свойства:
- Идентификатор этого элемента меню. Это простой строковый идентификатор, полезный для поиска конкретного элемента меню в дереве сцены.
- Параметры:
-
value- значение свойстваid - См. также:
getId
public final String getId()
id.idProperty
public final StringProperty idProperty()
- Возвращает:
- свойство
id - См. также:
setStyle
public final void setStyle(String value)
style.- Описание свойства:
- Строковое представление CSS-стиля, связанного с этим конкретным элементом меню. Аналогично атрибуту "style" HTML-элемента. Обратите внимание, что, как и атрибут HTML-стиля, эта переменная содержит свойства и значения стилей, а не часть селектора правила стиля.
- Параметры:
-
value- значение свойстваstyle - См. также:
getStyle
public final String getStyle()
style.- Определено в:
-
getStyleв интерфейсеStyleable - Описание свойства:
- Строковое представление CSS-стиля, связанного с этим конкретным элементом меню. Аналогично атрибуту "style" HTML-элемента. Обратите внимание, что, как и атрибут HTML-стиля, эта переменная содержит свойства и значения стилей, а не часть селектора правила стиля.
- Возвращает:
- значение свойства
style - См. также:
styleProperty
public final StringProperty styleProperty()
- Возвращает:
- свойство
style - См. также:
setParentMenu
protected final void setParentMenu(Menu value)
parentMenu.- Описание свойства:
- Это
Menu, в котором существует этотMenuItem. Возможно, у экземпляра этого класса нетparentMenu- это означает, что этот экземпляр либо:- Еще не связан со своим
parentMenu. - 'Корневой'
Menu(то есть это контекстное меню, прикрепленное непосредственно кMenuBar,MenuButtonили другим элементам управления, использующимMenuвнутри).
- Еще не связан со своим
- Параметры:
-
value- значение для свойстваparentMenu - См. также:
getParentMenu
public final Menu getParentMenu()
parentMenu.- Описание свойства:
- Это
Menu, в котором существует этотMenuItem. Возможно, у экземпляра этого класса нетparentMenu- это означает, что этот экземпляр либо:- Еще не связан со своим
parentMenu. - 'Корневой'
Menu(то есть это контекстное меню, прикрепленное непосредственно кMenuBar,MenuButtonили другим элементам управления, использующимMenuвнутри).
- Еще не связан со своим
- Возвращает:
- значение свойства
parentMenu - См. также:
parentMenuProperty
public final ReadOnlyObjectProperty<Menu> parentMenuProperty()
Menu, в котором существует этот MenuItem. Возможно, у экземпляра этого класса нет parentMenu - это означает, что этот экземпляр либо: - Еще не связан со своим
parentMenu. - 'Корневой'
Menu(то есть это контекстное меню, прикрепленное непосредственно кMenuBar,MenuButtonили другим элементам управления, использующимMenuвнутри).
- Возвращает:
- свойство
parentMenu - См. также:
setParentPopup
protected final void setParentPopup(ContextMenu value)
parentPopup.- Описание свойства:
- Это
ContextMenu, в котором существует этотMenuItem. - Параметры:
-
value- значение для свойстваparentPopup - См. также:
getParentPopup
public final ContextMenu getParentPopup()
parentPopup.- Описание свойства:
- Это
ContextMenu, в котором существует этотMenuItem. - Возвращает:
- значение свойства
parentPopup - См. также:
parentPopupProperty
public final ReadOnlyObjectProperty<ContextMenu> parentPopupProperty()
ContextMenu, в котором существует этот MenuItem.- Возвращает:
- свойство
parentPopup - См. также:
setText
public final void setText(String value)
text.- Описание свойства:
- Текст для отображения в
MenuItem. - Параметры:
-
value- значение для свойстваtext - См. также:
getText
public final String getText()
text.- Описание свойства:
- Текст для отображения в
MenuItem. - Возвращает:
- значение свойства
text - См. также:
textProperty
public final StringProperty textProperty()
MenuItem.- Возвращает:
- свойство
text - См. также:
setGraphic
public final void setGraphic(Node value)
graphic.- Описание свойства:
- Необязательная графика для
MenuItem. Обычно это узелImageView, но это не обязательно. - Параметры:
-
value- значение для свойстваgraphic - См. также:
getGraphic
public final Node getGraphic()
graphic.- Описание свойства:
- Необязательная графика для
MenuItem. Обычно это узелImageView, но это не обязательно. - Возвращает:
- значение свойства
graphic - См. также:
graphicProperty
public final ObjectProperty<Node> graphicProperty()
MenuItem. Обычно это узел ImageView, но это не обязательно.- Возвращает:
- свойство
graphic - См. также:
setOnAction
public final void setOnAction(EventHandler<ActionEvent> value)
onAction.- Описание свойства:
- Действие, которое вызывается всякий раз, когда MenuItem срабатывает. Это может быть вызвано нажатием пользователем кнопки мышью, или сенсорным событием, или нажатием клавиши, или если разработчик программно вызывает метод
fire(). - Параметры:
-
value- значение для свойстваonAction - См. также:
getOnAction
public final EventHandler<ActionEvent> getOnAction()
onAction.- Описание свойства:
- Действие, которое вызывается всякий раз, когда MenuItem срабатывает. Это может быть вызвано нажатием пользователем кнопки мышью, или сенсорным событием, или нажатием клавиши, или если разработчик программно вызывает метод
fire(). - Возвращает:
- значение свойства
onAction - См. также:
onActionProperty
public final ObjectProperty<EventHandler<ActionEvent>> onActionProperty()
fire().- Возвращает:
- свойство
onAction - См. также:
setOnMenuValidation
public final void setOnMenuValidation(EventHandler<Event> value)
onMenuValidation.- Описание свойства:
- Обработчик событий, связанный с вызовом акселератора для MenuItem. Это может произойти при нажатии комбинации клавиш для акселератора. Обработчик событий также вызывается при вызове обработчика события onShowing.
- Параметры:
-
value- значение для свойстваonMenuValidation - С момента:
- JavaFX 2.2
- См. также:
getOnMenuValidation
public final EventHandler<Event> getOnMenuValidation()
onMenuValidation.- Описание свойства:
- Обработчик событий, связанный с вызовом акселератора для MenuItem. Это может произойти при нажатии комбинации клавиш для акселератора. Обработчик событий также вызывается при вызове обработчика события onShowing.
- Возвращает:
- значение свойства
onMenuValidation - С момента:
- JavaFX 2.2
- См. также:
onMenuValidationProperty
public final ObjectProperty<EventHandler<Event>> onMenuValidationProperty()
- Возвращает:
- свойство
onMenuValidation - С момента:
- JavaFX 2.2
- См. также:
setDisable
public final void setDisable(boolean value)
disable.- Описание свойства:
- Устанавливает состояние отключения для данного MenuItem. Установка disable в true отключит этот MenuItem.
- Параметры:
-
value- значение для свойстваdisable - См. также:
isDisable
public final boolean isDisable()
disable.- Описание свойства:
- Устанавливает состояние отключения для данного MenuItem. Установка disable в true отключит этот MenuItem.
- Возвращает:
- значение свойства
disable - См. также:
disableProperty
public final BooleanProperty disableProperty()
- Возвращает:
- свойство
disable - См. также:
setVisible
public final void setVisible(boolean value)
visible.- Описание свойства:
- Определяет, должен ли этот MenuItem отображаться в виде части графа сцены.
- Параметры:
-
value- значение для свойстваvisible - См. также:
isVisible
public final boolean isVisible()
visible.- Описание свойства:
- Определяет, должен ли этот MenuItem отображаться в виде части графа сцены.
- Возвращает:
- значение свойства
visible - См. также:
visibleProperty
public final BooleanProperty visibleProperty()
- Возвращает:
- свойство
visible - См. также:
УстановитьУскоритель
public final void setAccelerator(KeyCombination value)
accelerator.- Описание свойства:
- Свойство ускорителя позволяет получить доступ к связанному действию одним нажатием клавиши. Это удобство для быстрого выполнения заданного действия.
- Параметры:
-
value- значение свойстваaccelerator - См. также:
ПолучитьУскоритель
public final KeyCombination getAccelerator()
accelerator.- Описание свойства:
- Свойство ускорителя позволяет получить доступ к связанному действию одним нажатием клавиши. Это удобство для быстрого выполнения заданного действия.
- Возвращает:
- значение свойства
accelerator - См. также:
свойствоУскоритель
public final ObjectProperty<KeyCombination> acceleratorProperty()
- Возвращает:
- свойство
accelerator - См. также:
установитьРазборМемо
public final void setMnemonicParsing(boolean value)
mnemonicParsing.- Описание свойства:
- Свойство mnemonicParsing для включения/отключения разбора текста. Если оно установлено в true, то текст элемента MenuItem будет проанализирован на наличие символа разбора mnemonics '_'. При обнаружении mnemonics, сочетание клавиш будет определено на основе следующего символа, и mnemonics будет добавлен.
Значение по умолчанию для MenuItem равно true.
- Параметры:
-
value- значение свойстваmnemonicParsing - См. также:
являетсяРазборомМемо
public final boolean isMnemonicParsing()
mnemonicParsing.- Описание свойства:
- Свойство mnemonicParsing для включения/отключения разбора текста. Если оно установлено в true, то текст элемента MenuItem будет проанализирован на наличие символа разбора mnemonics '_'. При обнаружении mnemonics, сочетание клавиш будет определено на основе следующего символа, и mnemonics будет добавлен.
Значение по умолчанию для MenuItem равно true.
- Возвращает:
- значение свойства
mnemonicParsing - См. также:
свойствоРазбораМемо
public final BooleanProperty mnemonicParsingProperty()
Значение по умолчанию для MenuItem равно true.
- Возвращает:
- свойство
mnemonicParsing - См. также:
получитьСтильКласс
public ObservableList<String> getStyleClass()
Styleable- Определено в:
-
getStyleClassв интерфейсеStyleable - Возвращает:
- список идентификаторов строк, которые могут быть использованы для логической группировки узлов, в частности, для внешнего движка стилей
- См. также:
запустить
public void fire()
сформироватьЦепьДиспечеризацииСобытий
public EventDispatchChain buildEventDispatchChain(EventDispatchChain tail)
EventTargetEventTarget. Этот целевой объект событий не добавляется автоматически в цепь, поэтому, если он хочет обрабатывать события, ему нужно добавить EventDispatcher для себя в цепь. В случае, если целевой объект событий является частью иерархии, цепь для него обычно строится из диспечеров событий, собранных от корня иерархии до целевого объекта событий.
Цепь диспечеризации событий строится путем модификации предоставленной начальной цепи диспечеризации событий. Возвращаемая цепь должна иметь начальную цепь в конце, поэтому диспечеры должны быть добавлены в начало начальной цепи.
Вызывающий не должен предполагать, что начальная цепь останется неизменной или что возвращаемое значение будет ссылаться на другую цепь.
- Определено в:
-
buildEventDispatchChainв интерфейсеEventTarget - Параметры:
-
tail- начальная цепь для построения - Возвращает:
- результирующая цепь диспечеризации событий для этого целевого объекта
получитьПользовательскиеДанные
public Object getUserData()
Object, установленное методом setUserData(Object), или null, если никакой объект не был задан.- Возвращает:
- объект пользователя, который был сохранен (включая
null), илиnull, если объект не был задан
установитьПользовательскиеДанные
public void setUserData(Object value)
getUserData().- Параметры:
-
value- объект пользователя для хранения
получитьСвойства
public ObservableMap<Object,Object> getProperties()
- Возвращает:
- наблюдаемую карту свойств этого элемента меню, предназначенную в первую очередь для разработчиков приложений
получитьСелекторТипа
public String getTypeSelector()
Styleable, который будет использоваться в соответствии с селектором. Это аналогично «элементу» в HTML. (CSS Type Selector).- Определено в:
-
getTypeSelectorв интерфейсеStyleable - Возвращает:
- "MenuItem"
- С:
- JavaFX 8.0
получитьСтилепригодногоРодителя
public Styleable getStyleableParent()
- Определено в:
-
getStyleableParentв интерфейсеStyleable - Возвращает:
-
getParentMenu(), илиgetParentPopup()еслиparentMenuравно null - С:
- JavaFX 8.0
получитьСостоянияПсевдокласса
public final ObservableSet<PseudoClass> getPseudoClassStates()
- Определено в:
-
getPseudoClassStatesв интерфейсеStyleable - Возвращает:
- состояние псевдокласса
- С:
- JavaFX 8.0
получитьCssMetaData
public List<CssMetaData<? extends Styleable,?>> getCssMetaData()
Styleable- Определено в:
-
getCssMetaDataв интерфейсеStyleable - Возвращает:
- CssMetaData
© 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.