Класс 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<KeyCombination> |
accelerator |
Свойство ускорителя позволяет получить доступ к связанному действию в один нажатие клавиши. |
final BooleanProperty |
disable |
Устанавливает индивидуальное состояние отключения для этого MenuItem. |
final ObjectProperty<Node> |
graphic |
Необязательный графический элемент для MenuItem. |
final StringProperty |
id |
Идентификатор этого MenuItem. |
final BooleanProperty |
mnemonicParsing |
Свойство mnemonicParsing для включения/выключения анализа текста. |
final ObjectProperty<EventHandler<ActionEvent>> |
onAction |
Действие, которое вызывается всякий раз, когда MenuItem активируется. |
final ObjectProperty<EventHandler<Event>> |
onMenuValidation |
Обработчик событий, связанный с вызовом ускорителя для MenuItem. |
final ReadOnlyObjectProperty<Menu> |
parentMenu |
Это Menu, в котором существует данный MenuItem. |
final ReadOnlyObjectProperty<ContextMenu> |
parentPopup |
Это ContextMenu, в котором существует данный MenuItem. |
final StringProperty |
style |
Строковое представление CSS-стиля, связанного с этим конкретным MenuItem. |
final StringProperty |
text |
Текст, который должен быть отображён в MenuItem. |
final BooleanProperty |
visible |
Указывает, должен ли этот MenuItem быть отображён в графическом дереве. |
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
static final EventType<Event> |
MENU_VALIDATION_EVENT |
Вызывается при вызове ускорителя для MenuItem. |
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
MenuItem() |
Создаёт MenuItem без текста для отображения. |
MenuItem |
Создаёт MenuItem и устанавливает текст для отображения с указанным текстом. |
MenuItem |
Конструктор MenuItem и устанавливает текст для отображения с указанным текстом и устанавливает графический элемент Node на заданный узел. |
Краткое описание методов
| Modifier and Type | Method | Description |
|---|---|---|
final ObjectProperty<KeyCombination> |
acceleratorProperty() |
Свойство accelerator позволяет получить связанное действие в один нажатие клавиши. |
EventDispatchChain |
buildEventDispatchChain |
Создает цепочку обработки событий для этого целевого объекта. |
final BooleanProperty |
disableProperty() |
Устанавливает индивидуальное состояние disabled для этого пункта меню. |
void |
fire() |
Генерирует новое событие ActionEvent. |
final KeyCombination |
getAccelerator() |
Получает значение свойства accelerator. |
List<CssMetaData<? extends Styleable, |
getCssMetaData() |
CssMetaData для этого элемента Styleable. |
final Node |
getGraphic() |
Получает значение свойства graphic. |
final String |
getId() |
Получает значение свойства id. |
final EventHandler<ActionEvent> |
getOnAction() |
Получает значение свойства onAction. |
final EventHandler<Event> |
getOnMenuValidation() |
Получает значение свойства onMenuValidation. |
final Menu |
getParentMenu() |
Получает значение свойства parentMenu. |
final ContextMenu |
getParentPopup() |
Получает значение свойства parentPopup. |
ObservableMap<Object, |
getProperties() |
Возвращает наблюдаемую карту свойств этого пункта меню, предназначенную в основном для разработчиков приложений. |
final ObservableSet<PseudoClass> |
getPseudoClassStates() |
Возвращает состояние псевдокласса этого элемента Styleable. |
final String |
getStyle() |
Получает значение свойства style. |
Styleable |
getStyleableParent() |
Возвращает родителя этого элемента Styleable или null, если родителя нет. |
ObservableList<String> |
getStyleClass() |
Список идентификаторов типа String, которые могут использоваться для логической группировки узлов, в частности, для внешнего движка стилей. |
final String |
getText() |
Получает значение свойства text. |
String |
getTypeSelector() |
Тип этого Styleable, используемый для сопоставления с селекторами. |
Object |
getUserData() |
|
final ObjectProperty<Node> |
graphicProperty() |
Дополнительный графический элемент для MenuItem. |
final StringProperty |
idProperty() |
Идентификатор этого пункта меню. |
final boolean |
isDisable() |
Получает значение свойства disable. |
final boolean |
isMnemonicParsing() |
Получает значение свойства mnemonicParsing. |
final boolean |
isVisible() |
Получает значение свойства visible. |
final BooleanProperty |
mnemonicParsingProperty() |
Свойство MnemonicParsing для включения/выключения разбора текста. |
final ObjectProperty<EventHandler<ActionEvent>> |
onActionProperty() |
Действие, которое выполняется при срабатывании пункта меню. |
final ObjectProperty<EventHandler<Event>> |
onMenuValidationProperty() |
Обработчик событий, связанный с вызовом ускорителя для пункта меню. |
final ReadOnlyObjectProperty<Menu> |
parentMenuProperty() |
Это Menu, в котором существует этот MenuItem. |
final ReadOnlyObjectProperty<ContextMenu> |
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.- Описание свойства:
- Идентификатор (id) этого пункта меню. Эта простая строковая метка полезна для поиска конкретного пункта меню в графическом представлении сцены.
- Параметры:
-
value- значение для свойстваid - См. также:
getId
public final String getId()
id.- Определено в:
-
getIdв интерфейсеStyleable - Описание свойства:
- Идентификатор (id) этого пункта меню. Эта простая строковая метка полезна для поиска конкретного пункта меню в графическом представлении сцены.
- Возвращает:
- значение свойства
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 - Since:
- JavaFX 2.2
- См. также:
getOnMenuValidation
public final EventHandler<Event> getOnMenuValidation()
onMenuValidation.- Описание свойства:
- Обработчик событий, связанный с вызовом активатора для элемента меню MenuItem. Это может произойти при нажатии сочетания клавиш активатора. Обработчик событий также вызывается, когда вызывается обработчик события onShowing.
- Возвращает:
- значение свойства
onMenuValidation - Since:
- JavaFX 2.2
- См. также:
onMenuValidationProperty
public final ObjectProperty<EventHandler<Event>> onMenuValidationProperty()
- Возвращает:
- свойство
onMenuValidation - Since:
- JavaFX 2.2
- См. также:
setDisable
public final void setDisable(boolean value)
disable.- Описание свойства:
- Устанавливает индивидуальное состояние отключения для этого элемента меню. Установка disable в true сделает этот элемент меню неактивным.
- Параметры:
-
value- значение свойстваdisable - См. также:
isDisable
public final boolean isDisable()
disable.- Описание свойства:
- Устанавливает индивидуальное состояние отключения для этого элемента меню. Установка disable в true сделает этот элемент меню неактивным.
- Возвращает:
- значение свойства
disable - См. также:
disableProperty
public final BooleanProperty disableProperty()
- Возвращает:
- свойство
disable - См. также:
setVisible
public final void setVisible(boolean value)
visible.- Описание свойства:
- Определяет, должен ли этот элемент меню отображаться в качестве части графа сцены.
- Параметры:
-
value- значение свойстваvisible - См. также:
isVisible
public final boolean isVisible()
visible.- Описание свойства:
- Определяет, должен ли этот элемент меню отображаться в качестве части графа сцены.
- Возвращает:
- значение свойства
visible - См. также:
visibleProperty
public final BooleanProperty visibleProperty()
- Возвращает:
- свойство
visible - См. также:
setAccelerator
public final void setAccelerator(KeyCombination value)
accelerator.- Описание свойства:
- Свойство активатора позволяет получить связанное действие одним нажатием клавиши. Это удобство для быстрого выполнения заданного действия.
- Параметры:
-
value- значение свойстваaccelerator - См. также:
getAccelerator
public final KeyCombination getAccelerator()
accelerator.- Описание свойства:
- Свойство активатора позволяет получить связанное действие одним нажатием клавиши. Это удобство для быстрого выполнения заданного действия.
- Возвращает:
- значение свойства
accelerator - См. также:
acceleratorProperty
public final ObjectProperty<KeyCombination> acceleratorProperty()
- Возвращает:
- свойство
accelerator - См. также:
setMnemonicParsing
public final void setMnemonicParsing(boolean value)
mnemonicParsing.- Описание свойства:
- Свойство mnemonicParsing для включения/отключения анализа текста. Если это значение установлено в true, текст элемента MenuItem будет проанализирован, чтобы определить, содержит ли он символ анализа мнемоники '_'. При обнаружении мнемоники сочетание клавиш будет определено на основе последующего символа, и мнемоника будет добавлена.
По умолчанию для MenuItem значение равно true.
- Параметры:
-
value- значение свойстваmnemonicParsing - См. также:
isMnemonicParsing
public final boolean isMnemonicParsing()
mnemonicParsing.- Описание свойства:
- Свойство mnemonicParsing для включения/отключения анализа текста. Если это значение установлено в true, текст элемента MenuItem будет проанализирован, чтобы определить, содержит ли он символ анализа мнемоники '_'. При обнаружении мнемоники сочетание клавиш будет определено на основе последующего символа, и мнемоника будет добавлена.
По умолчанию для MenuItem значение равно true.
- Возвращает:
- значение свойства
mnemonicParsing - См. также:
mnemonicParsingProperty
public final BooleanProperty mnemonicParsingProperty()
По умолчанию для MenuItem значение равно true.
- Возвращает:
- свойство
mnemonicParsing - См. также:
getStyleClass
public ObservableList<String> getStyleClass()
Styleable- Определено в:
-
getStyleClassв интерфейсеStyleable - Возвращает:
- список идентификаторов строк, которые могут быть использованы для логической группировки узлов, в частности, для внешнего механизма стилей
- См. также:
fire
public void fire()
buildEventDispatchChain
public EventDispatchChain buildEventDispatchChain(EventDispatchChain tail)
EventTargetEventTarget. Этот целевой объект события не добавляется автоматически в цепочку, поэтому, если он хочет обрабатывать события, ему необходимо добавить EventDispatcher для себя в цепочку. В случае, если целевой объект события является частью иерархии, цепочка для него обычно строится из обработчиков событий, собранных от корня иерархии до целевого объекта события.
Цепочка обработки событий строится путем модификаций предоставленной начальной цепочки обработки событий. Возвращаемая цепочка должна содержать начальную цепочку в конце, поэтому обработчики должны быть добавлены в начало начальной цепочки.
Вызывающий код не должен предполагать, что начальная цепочка остается неизменной или что возвращаемое значение будет ссылаться на другую цепочку.
- Определено в:
-
buildEventDispatchChainв интерфейсеEventTarget - Параметры:
-
tail- начальная цепочка, из которой производится построение - Возвращает:
- результирующая цепочка обработки событий для этого целевого объекта
getUserData
public Object getUserData()
Object, установленный методом setUserData(Object), или null, если никакой объект не был задан.- Возвращает:
- объект пользователя, который был сохранён (включая
null), илиnull, если никакой объект не был задан
setUserData
public void setUserData(Object value)
getUserData().- Параметры:
-
value- объект пользователя, который нужно сохранить
getProperties
public ObservableMap<Object,Object> getProperties()
- Возвращает:
- наблюдаемую карту свойств этого элемента меню, предназначенную в первую очередь для разработчиков приложений
getTypeSelector
public String getTypeSelector()
Styleable, используемый в соответствии с селектором. Аналогично "элементу" в HTML. (CSS селектор типа).- Определено в:
-
getTypeSelectorв интерфейсеStyleable - Возвращает:
- "MenuItem"
- С тех пор:
- JavaFX 8.0
getStyleableParent
public Styleable getStyleableParent()
- Определено в:
-
getStyleableParentв интерфейсеStyleable - Возвращает:
-
getParentMenu()илиgetParentPopup(), еслиparentMenuравно null - С тех пор:
- JavaFX 8.0
getPseudoClassStates
public final ObservableSet<PseudoClass> getPseudoClassStates()
- Определено в:
-
getPseudoClassStatesв интерфейсеStyleable - Возвращает:
- состояние псевдокласса
- С тех пор:
- JavaFX 8.0
getCssMetaData
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.