Spec-Zone.ru › OpenJavaFX 21

Класс RadioMenuItem

java.lang.Object
javafx.scene.control.MenuItem
javafx.scene.control.RadioMenuItem
Все реализуемые интерфейсы:
Styleable, EventTarget, Toggle
public class RadioMenuItem extends MenuItem implements Toggle

RadioMenuItem — это MenuItem, который можно переключать (он использует миксин Toggle). Это означает, что у RadioMenuItem API очень похож по своей природе на другие элементы управления, использующие Toggle, такие как RadioButton и ToggleButton. RadioMenuItem специально предназначен для использования внутри Menu, поэтому для получения дополнительной информации о добавлении RadioMenuItem в него следует обратиться к документации API этого класса.

Для создания простого, не сгруппированного RadioMenuItem выполните следующие действия:

RadioMenuItem radioItem = new RadioMenuItem("radio text");
radioItem.setSelected(false);
radioItem.setOnAction(e -> System.out.println("radio toggled"));

Проблема с приведенным выше примером заключается в том, что он не предлагает никаких преимуществ по сравнению с использованием обычного MenuItem. Как уже упоминалось, назначение RadioMenuItem заключается в предоставлении пользователю нескольких вариантов выбора и разрешении выбора только одного варианта в любой момент времени (т.е. выбор должен быть *взаимоисключающим*). Для достижения этой цели вы можете поместить ноль или более RadioMenuItem в группы. При группировании только один RadioMenuItem за раз в группе может быть выбран. Чтобы поместить два экземпляра RadioMenuItem в одну группу, просто присвойте им одинаковое значение для toggleGroup. Например:

ToggleGroup toggleGroup = new ToggleGroup();

RadioMenuItem radioItem1 = new RadioMenuItem("Option 1");
radioItem1.setOnAction(e -> System.out.println("radio1 toggled"));
radioItem1.setToggleGroup(toggleGroup);

RadioMenuItem radioItem2 = new RadioMenuItem("Option 2");
radioItem2.setOnAction(e -> System.out.println("radio2 toggled"));
radioItem2.setToggleGroup(toggleGroup);

Menu menu = new Menu("Selection");
menu.getItems().addAll(radioItem1, radioItem2);
MenuBar menuBar = new MenuBar(menu);
Image of the RadioMenuItem control

В этом примере, с обоими RadioMenuItem, назначенными одной и той же группе ToggleGroup, только один элемент может быть выбран в любой момент времени, и если выбор изменится, ToggleGroup позаботится о снятии выбора с предыдущего элемента.

С:
JavaFX 2.0
См. также:
  • MenuItem
  • Menu

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

Тип Свойство Описание
final BooleanProperty selected
Состояние выбранного элемента для этого Toggle.
final ObjectProperty<ToggleGroup> toggleGroup
Представляет ToggleGroup, к которому принадлежит этот RadioMenuItem.

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

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

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

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

MENU_VALIDATION_EVENT

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

Конструктор Описание
RadioMenuItem()
Создает RadioMenuItem без текста отображения.
RadioMenuItem(String text)
Создает RadioMenuItem и устанавливает текст отображения с указанным текстом.
RadioMenuItem(String text, Node graphic)
Создает RadioMenuItem и устанавливает текст отображения с указанным текстом и устанавливает графический Node на заданный узел.

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

Модификатор и тип Метод Описание
final ToggleGroup getToggleGroup()
Получает значение свойства toggleGroup.
final boolean isSelected()
Получает значение свойства selected.
final BooleanProperty selectedProperty()
Состояние выбранного элемента для этого Toggle.
final void setSelected(boolean value)
Устанавливает значение свойства selected.
final void setToggleGroup(ToggleGroup value)
Устанавливает значение свойства toggleGroup.
final ObjectProperty<ToggleGroup> toggleGroupProperty()
Представляет ToggleGroup, к которому принадлежит этот RadioMenuItem.

Методы, объявленные в классе 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

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

getProperties, getUserData, setUserData

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

toggleGroup

public final ObjectProperty<ToggleGroup> toggleGroupProperty
Представляет ToggleGroup, к которому принадлежит эта RadioMenuItem.
Определено:
toggleGroupProperty в интерфейсе Toggle
Возвращает:
свойство группы переключателей
См. также:
  • getToggleGroup()
  • setToggleGroup(ToggleGroup)
  • toggleGroupProperty()

selected

public final BooleanProperty selectedProperty
Определено:
selectedProperty в интерфейсе Toggle
Возвращает:
свойство выбранного элемента
См. также:
  • isSelected()
  • setSelected(boolean)
  • selectedProperty()

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

RadioMenuItem

public RadioMenuItem()
Создает RadioMenuItem без текста отображения.

RadioMenuItem

public RadioMenuItem(String text)
Создает RadioMenuItem и устанавливает текст отображения с указанным текстом.
Параметры:
text - текст отображения

RadioMenuItem

public RadioMenuItem(String text, Node graphic)
Создает RadioMenuItem и устанавливает текст отображения с указанным текстом и устанавливает графическое представление Node для данного узла.
Параметры:
text - текст отображения
graphic - графический узел

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

setToggleGroup

public final void setToggleGroup(ToggleGroup value)
Устанавливает значение свойства toggleGroup.
Определено:
setToggleGroup в интерфейсе Toggle
Описание свойства:
Представляет ToggleGroup, к которому принадлежит эта RadioMenuItem.
Параметры:
value - значение для свойства toggleGroup
См. также:
  • getToggleGroup()
  • toggleGroupProperty()

getToggleGroup

public final ToggleGroup getToggleGroup()
Получает значение свойства toggleGroup.
Определено:
getToggleGroup в интерфейсе Toggle
Описание свойства:
Представляет ToggleGroup, к которому принадлежит эта RadioMenuItem.
Возвращает:
значение свойства toggleGroup
См. также:
  • setToggleGroup(ToggleGroup)
  • toggleGroupProperty()

toggleGroupProperty

public final ObjectProperty<ToggleGroup> toggleGroupProperty()
Представляет ToggleGroup, к которому принадлежит эта RadioMenuItem.
Определено:
toggleGroupProperty в интерфейсе Toggle
Возвращает:
свойство toggleGroup
См. также:
  • getToggleGroup()
  • setToggleGroup(ToggleGroup)

setSelected

public final void setSelected(boolean value)
Устанавливает значение свойства selected.
Определено:
setSelected в интерфейсе Toggle
Описание свойства:
Параметры:
value - значение для свойства selected
См. также:
  • isSelected()
  • selectedProperty()

isSelected

public final boolean isSelected()
Получает значение свойства selected.
Определено:
isSelected в интерфейсе Toggle
Описание свойства:
Возвращает:
значение свойства selected
См. также:
  • setSelected(boolean)
  • selectedProperty()

selectedProperty

public final BooleanProperty selectedProperty()
Описание скопировано из интерфейса: Toggle
Состояние выбранного элемента для данного Toggle.
Определено:
selectedProperty в интерфейсе Toggle
Возвращает:
свойство selected
См. также:
  • isSelected()
  • setSelected(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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API