Класс 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); - C момента:
- JavaFX 2.0
- См. также:
Menu
Краткое описание свойств
| Тип | Свойство | Описание |
|---|---|---|
ObjectProperty<KeyCombination> | accelerator | Свойство ускорителя позволяет получить доступ к связанному действию одним нажатием клавиши. |
BooleanProperty | disable | Устанавливает индивидуальное состояние недоступности для этого MenuItem. |
ObjectProperty<Node> | graphic | Необязательная графика для MenuItem. |
StringProperty | id | Идентификатор этого MenuItem. |
BooleanProperty | mnemonicParsing | Свойство mnemonicParsing для включения/выключения обработки текста. |
ObjectProperty<EventHandler<ActionEvent>> | onAction | Действие, которое выполняется при срабатывании MenuItem. |
ObjectProperty<EventHandler<Event>> | onMenuValidation | Обработчик событий, связанный с вызовом ускорителя для MenuItem. |
ReadOnlyObjectProperty<Menu> | parentMenu | Это Menu, в котором существует этот MenuItem. |
ReadOnlyObjectProperty<ContextMenu> | parentPopup | Это ContextMenu, в котором существует этот MenuItem. |
StringProperty | style | Строковое представление CSS-стиля, связанного с этим конкретным MenuItem. |
StringProperty | text | Текст для отображения в MenuItem. |
BooleanProperty | visible | Указывает, должен ли этот MenuItem отображаться в графическом дереве сцены. |
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
static EventType<Event> | MENU_VALIDATION_EVENT | Вызывается при вызове ускорителя для MenuItem |
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
MenuItem() | Создает MenuItem без текста для отображения. |
MenuItem(String text) | Создает MenuItem и устанавливает текст для отображения со значением specified text |
MenuItem(String text,
Node graphic) | Конструктор s MenuItem и устанавливает текст для отображения со значением specified text и устанавливает графику Node в заданный узел. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|
ObjectProperty<KeyCombination> | acceleratorProperty() | Свойство ускорителя позволяет получить доступ к связанному действию одним нажатием клавиши. |
|---|---|---|
<E extends Event> | addEventHandler(EventType<E> eventType,
EventHandler<E> eventHandler) | Регистрирует обработчик событий для этого элемента меню. |
BooleanProperty | disableProperty() | Устанавливает индивидуальное состояние отключения для этого элемента меню. |
void | fire() | Вызывает новое событие ActionEvent. |
KeyCombination | getAccelerator() | Получает значение свойства accelerator. |
Node | getGraphic() | Получает значение свойства graphic. |
EventHandler<ActionEvent> | getOnAction() | Получает значение свойства onAction. |
EventHandler<Event> | getOnMenuValidation() | Получает значение свойства onMenuValidation. |
Menu | getParentMenu() | Получает значение свойства parentMenu. |
ContextMenu | getParentPopup() | Получает значение свойства parentPopup. |
ObservableMap<Object,Object> | getProperties() | Возвращает наблюдаемую карту свойств этого пункта меню, предназначенную в основном для разработчиков приложений. |
ObservableSet<PseudoClass> | getPseudoClassStates() | Возвращает состояние псевдокласса этого Styleable. |
Styleable | getStyleableParent() | Возвращает родителя этого Styleable или null, если родителя нет. |
String | getText() | Получает значение свойства text. |
String | getTypeSelector() | Тип этого Styleable, который будет использоваться при сопоставлении селекторов. |
Object | getUserData() | Возвращает Object, установленное методом setUserData(Object), или null, если объект не был установлен. |
ObjectProperty<Node> | graphicProperty() | Необязательная графика для MenuItem. |
StringProperty | idProperty() | Идентификатор этого элемента меню. |
boolean | isDisable() | Получает значение свойства disable. |
boolean | isMnemonicParsing() | Получает значение свойства mnemonicParsing. |
boolean | isVisible() | Получает значение свойства visible. |
BooleanProperty | mnemonicParsingProperty() | Свойство mnemonicParsing для включения/выключения анализа текста. |
ObjectProperty<EventHandler<ActionEvent>> | onActionProperty() | Действие, которое вызывается всякий раз, когда элемент меню активируется. |
ObjectProperty<EventHandler<Event>> | onMenuValidationProperty() | Обработчик событий, связанный с вызовом ускорителя для элемента меню. |
ReadOnlyObjectProperty<Menu> | parentMenuProperty() | Это Menu, в котором существует этот MenuItem. |
ReadOnlyObjectProperty<ContextMenu> | parentPopupProperty() | Это ContextMenu, в котором существует этот MenuItem. |
<E extends Event> | removeEventHandler(EventType<E> eventType,
EventHandler<E> eventHandler) | Отменяет регистрацию ранее зарегистрированного обработчика событий из этого элемента меню. |
void | setAccelerator(KeyCombination value) | Устанавливает значение свойства accelerator. |
void | setDisable(boolean value) | Устанавливает значение свойства disable. |
void | setGraphic(Node value) | Устанавливает значение свойства graphic. |
void | setId(String value) | Устанавливает значение свойства id. |
void | setMnemonicParsing(boolean value) | Устанавливает значение свойства mnemonicParsing. |
void | setOnAction(EventHandler<ActionEvent> value) | Устанавливает значение свойства onAction. |
void | setOnMenuValidation(EventHandler<Event> value) | Устанавливает значение свойства onMenuValidation. |
protected void | setParentMenu(Menu value) | Устанавливает значение свойства parentMenu. |
protected void | setParentPopup(ContextMenu value) | Устанавливает значение свойства parentPopup. |
void | setStyle(String value) | Устанавливает значение свойства style. |
void | setText(String value) | Устанавливает значение свойства text. |
void | setUserData(Object value) | Хранит пользовательский объект, содержащий данные по своему усмотрению. |
void | setVisible(boolean value) | Устанавливает значение свойства visible. |
StringProperty | styleProperty() | Строковое представление CSS-стиля, связанного с этим конкретным элементом меню. |
StringProperty | textProperty() | Текст для отображения в MenuItem. |
BooleanProperty | 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
Подробности свойств
id
public final StringProperty idProperty
- См. также:
-
Styleable.getId(),setId(String)
style
public final StringProperty styleProperty
- См. также:
-
Styleable.getStyle(),setStyle(String)
parentMenu
public final ReadOnlyObjectProperty<Menu> parentMenuProperty
Menu, в котором существует этот MenuItem. Возможен случай, когда у экземпляра этого класса нет parentMenu – это означает, что этот экземпляр: - Еще не связан со своим
parentMenu. - «Корневой»
Menu(т.е. это контекстное меню, прикрепленное непосредственно кMenuBar,MenuButtonили другим элементам управления, использующимMenuвнутри).
- См. также:
-
getParentMenu(),setParentMenu(Menu)
parentPopup
public final ReadOnlyObjectProperty<ContextMenu> parentPopupProperty
ContextMenu, в котором существует этот MenuItem.- См. также:
-
getParentPopup(),setParentPopup(ContextMenu)
text
public final StringProperty textProperty
MenuItem.- См. также:
-
getText(),setText(String)
graphic
public final ObjectProperty<Node> graphicProperty
MenuItem. Обычно это узел ImageView, но это не обязательно.- См. также:
-
getGraphic(),setGraphic(Node)
onAction
public final ObjectProperty<EventHandler<ActionEvent>> onActionProperty
fire().- См. также:
-
getOnAction(),setOnAction(EventHandler)
onMenuValidation
public final ObjectProperty<EventHandler<Event>> onMenuValidationProperty
- С:
- JavaFX 2.2
- См. также:
-
getOnMenuValidation(),setOnMenuValidation(EventHandler)
disable
public final BooleanProperty disableProperty
- См. также:
-
isDisable(),setDisable(boolean)
visible
public final BooleanProperty visibleProperty
- См. также:
-
isVisible(),setVisible(boolean)
accelerator
public final ObjectProperty<KeyCombination> acceleratorProperty
- См. также:
-
getAccelerator(),setAccelerator(KeyCombination)
mnemonicParsing
public final BooleanProperty mnemonicParsingProperty
Значение по умолчанию для MenuItem – true.
- См. также:
-
isMnemonicParsing(),setMnemonicParsing(boolean)
Подробности полей
MENU_VALIDATION_EVENT
public static final EventType<Event> MENU_VALIDATION_EVENT
Вызывается при вызове ускорителя для пункта меню
- С:
- JavaFX 2.2
Подробности конструкторов
MenuItem
public MenuItem()
MenuItem
public MenuItem(String text)
- Параметры:
-
text- отображаемый текст - См. также:
setText(java.lang.String)
MenuItem
public MenuItem(String text, Node graphic)
Node на заданный узел.- Параметры:
-
text- отображаемый текст -
graphic- узел графики - См. также:
-
setText(java.lang.String),setGraphic(javafx.scene.Node)
Подробности методов
setId
public final void setId(String value)
- Описание свойства:
- Идентификатор этого пункта меню. Это простой строковый идентификатор, полезный для поиска конкретного пункта меню в графическом дереве.
idProperty
public final StringProperty idProperty()
- См. также:
-
Styleable.getId(),setId(String)
setStyle
public final void setStyle(String value)
- Описание свойства:
- Строковое представление CSS-стиля, связанного с этим конкретным пунктом меню. Аналогично атрибуту «style» HTML-элемента. Обратите внимание, что, как и атрибут HTML style, эта переменная содержит свойства и значения стилей, а не часть правила стиля.
styleProperty
public final StringProperty styleProperty()
- См. также:
-
Styleable.getStyle(),setStyle(String)
setParentMenu
protected final void setParentMenu(Menu value)
- Описание свойства:
- Это
Menu, в котором существует этотMenuItem. Возможен случай, когда у экземпляра этого класса нетparentMenu– это означает, что этот экземпляр:- Еще не связан со своим
parentMenu. - «Корневой»
Menu(т.е. это контекстное меню, прикрепленное непосредственно кMenuBar,MenuButtonили другим элементам управления, использующимMenuвнутри).
- Еще не связан со своим
getParentMenu
public final Menu getParentMenu()
- Описание свойства:
- Это
Menu, в котором существует этотMenuItem. Возможно, у экземпляра этого класса нетparentMenu— это означает, что этот экземпляр либо:- Ещё не связан со своим
parentMenu. - является 'корневым'
Menu(т.е. это контекстное меню, прикреплённое напрямую кMenuBar,MenuButtonили любому другому элементу управления, использующемуMenuвнутри).
- Ещё не связан со своим
parentMenuProperty
public final ReadOnlyObjectProperty<Menu> parentMenuProperty()
Menu, в котором существует этот MenuItem. Возможно, у экземпляра этого класса нет parentMenu — это означает, что этот экземпляр либо: - Ещё не связан со своим
parentMenu. - является 'корневым'
Menu(т.е. это контекстное меню, прикреплённое напрямую кMenuBar,MenuButtonили любому другому элементу управления, использующемуMenuвнутри).
- См. также:
-
getParentMenu(),setParentMenu(Menu)
setParentPopup
protected final void setParentPopup(ContextMenu value)
- Описание свойства:
- Это
ContextMenu, в котором существует этотMenuItem.
getParentPopup
public final ContextMenu getParentPopup()
- Описание свойства:
- Это
ContextMenu, в котором существует этотMenuItem.
parentPopupProperty
public final ReadOnlyObjectProperty<ContextMenu> parentPopupProperty()
ContextMenu, в котором существует этот MenuItem.- См. также:
-
getParentPopup(),setParentPopup(ContextMenu)
setText
public final void setText(String value)
- Описание свойства:
- Текст, отображаемый в
MenuItem.
getText
public final String getText()
- Описание свойства:
- Текст, отображаемый в
MenuItem.
textProperty
public final StringProperty textProperty()
MenuItem.- См. также:
-
getText(),setText(String)
setGraphic
public final void setGraphic(Node value)
- Описание свойства:
- Необязательная графика для
MenuItem. Обычно это узелImageView, но это не обязательно.
getGraphic
public final Node getGraphic()
- Описание свойства:
- Необязательная графика для
MenuItem. Обычно это узелImageView, но это не обязательно.
graphicProperty
public final ObjectProperty<Node> graphicProperty()
MenuItem. Обычно это узел ImageView, но это не обязательно.- См. также:
-
getGraphic(),setGraphic(Node)
setOnAction
public final void setOnAction(EventHandler<ActionEvent> value)
- Описание свойства:
- Действие, вызываемое при срабатывании пункта меню. Это может произойти из-за нажатия пользователем кнопки мышью, касания, нажатия клавиши или если разработчик программно вызывает метод
fire().
getOnAction
public final EventHandler<ActionEvent> getOnAction()
- Описание свойства:
- Действие, вызываемое при срабатывании пункта меню. Это может произойти из-за нажатия пользователем кнопки мышью, касания, нажатия клавиши или если разработчик программно вызывает метод
fire().
onActionProperty
public final ObjectProperty<EventHandler<ActionEvent>> onActionProperty()
fire().- См. также:
-
getOnAction(),setOnAction(EventHandler)
setOnMenuValidation
public final void setOnMenuValidation(EventHandler<Event> value)
- Описание свойства:
- Обработчик событий, связанный с вызовом акселератора для пункта меню. Это может произойти при нажатии комбинации клавиш акселератора. Обработчик событий также вызывается при вызове обработчика события onShowing.
- С:
- JavaFX 2.2
getOnMenuValidation
public final EventHandler<Event> getOnMenuValidation()
- Описание свойства:
- Обработчик событий, связанный с вызовом акселератора для пункта меню. Это может произойти при нажатии комбинации клавиш акселератора. Обработчик событий также вызывается при вызове обработчика события onShowing.
- С:
- JavaFX 2.2
onMenuValidationProperty
public final ObjectProperty<EventHandler<Event>> onMenuValidationProperty()
- С:
- JavaFX 2.2
- См. также:
-
getOnMenuValidation(),setOnMenuValidation(EventHandler)
setDisable
public final void setDisable(boolean value)
- Описание свойства:
- Устанавливает состояние отключения данного пункта меню. Установка disable в true отключит этот пункт меню.
isDisable
public final boolean isDisable()
- Описание свойства:
- Устанавливает состояние отключения данного пункта меню. Установка disable в true отключит этот пункт меню.
disableProperty
public final BooleanProperty disableProperty()
- См. также:
-
isDisable(),setDisable(boolean)
setVisible
public final void setVisible(boolean value)
- Описание свойства:
- Определяет, будет ли этот пункт меню отображен в графическом дереве.
isVisible
public final boolean isVisible()
- Описание свойства:
- Определяет, будет ли этот пункт меню отображен в графическом дереве.
visibleProperty
public final BooleanProperty visibleProperty()
- См. также:
-
isVisible(),setVisible(boolean)
УстановитьСочетаниеКлавиш
public final void setAccelerator(KeyCombination value)
- Описание свойства:
- Свойство сочетания клавиш позволяет получить доступ к связанному действию в один нажатие клавиш. Это удобство для быстрого выполнения заданного действия.
ПолучитьСочетаниеКлавиш
public final KeyCombination getAccelerator()
- Описание свойства:
- Свойство сочетания клавиш позволяет получить доступ к связанному действию в один нажатие клавиш. Это удобство для быстрого выполнения заданного действия.
СвойствоСочетанияКлавиш
public final ObjectProperty<KeyCombination> acceleratorProperty()
- См. также:
-
getAccelerator(),setAccelerator(KeyCombination)
УстановитьРазборМнемоники
public final void setMnemonicParsing(boolean value)
- Описание свойства:
- Свойство разбора мнемоники включает/отключает разбор текста. Если оно установлено в значение true, текст элемента меню будет проанализирован на наличие символа мнемоники '_'. При обнаружении мнемоники, сочетание клавиш будет определено на основе следующего символа, и мнемоника будет добавлена.
Значение по умолчанию для MenuItem равно true.
ПроверитьРазборМнемоники
public final boolean isMnemonicParsing()
- Описание свойства:
- Свойство разбора мнемоники включает/отключает разбор текста. Если оно установлено в значение true, текст элемента меню будет проанализирован на наличие символа мнемоники '_'. При обнаружении мнемоники, сочетание клавиш будет определено на основе следующего символа, и мнемоника будет добавлена.
Значение по умолчанию для MenuItem равно true.
СвойствоРазбораМнемоники
public final BooleanProperty mnemonicParsingProperty()
Значение по умолчанию для MenuItem равно true.
- См. также:
-
isMnemonicParsing(),setMnemonicParsing(boolean)
Сработать
public void fire()
ДобавитьОбработчикСобытий
public <E extends Event> void addEventHandler(EventType<E> eventType, EventHandler<E> eventHandler)
Event указанного типа во время фазы всплытия доставки события.- Параметры типов:
-
E- конкретный класс события для обработчика - Параметры:
-
eventType- тип событий, которые должен получить обработчик -
eventHandler- регистрируемый обработчик - Исключения:
-
NullPointerException- если тип события или обработчик равны null
УдалитьОбработчикСобытий
public <E extends Event> void removeEventHandler(EventType<E> eventType, EventHandler<E> eventHandler)
- Параметры типов:
-
E- конкретный класс события для обработчика - Параметры:
-
eventType- тип события, из которого необходимо удалить обработчик -
eventHandler- удаляемый обработчик - Исключения:
-
NullPointerException- если тип события или обработчик равны null
ПолучитьДанныеПользователя
public Object getUserData()
- Возвращает:
- хранимый объект пользователя (включая
null), илиnull, если объект не был задан
УстановитьДанныеПользователя
public void setUserData(Object value)
getUserData().- Параметры:
-
value- объект пользователя для хранения
ПолучитьСвойства
public ObservableMap<Object,Object> getProperties()
- Возвращает:
- наблюдаемую карту свойств данного элемента меню, предназначенную в первую очередь для разработчиков приложений
ПолучитьСелекторТипов
public String getTypeSelector()
Styleable, используемый для сопоставления селекторов. Аналогично элементу в HTML. (CSS Селектор Типов).- Определено в:
-
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
© 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.