Класс 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); В этом примере, с обоими RadioMenuItem, назначенными одной и той же группе ToggleGroup, только один элемент может быть выбран в любой момент времени, и если выбор изменится, ToggleGroup позаботится о снятии выбора с предыдущего элемента.
Краткое описание свойств
| Тип | Свойство | Описание |
|---|---|---|
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 |
Создает RadioMenuItem и устанавливает текст отображения с указанным текстом. |
RadioMenuItem |
Создает RadioMenuItem и устанавливает текст отображения с указанным текстом и устанавливает графический Node на заданный узел. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
final ToggleGroup |
getToggleGroup() |
Получает значение свойства toggleGroup. |
final boolean |
isSelected() |
Получает значение свойства selected. |
final BooleanProperty |
selectedProperty() |
Состояние выбранного элемента для этого Toggle. |
final void |
setSelected |
Устанавливает значение свойства selected. |
final void |
setToggleGroup |
Устанавливает значение свойства 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 - Возвращает:
- свойство группы переключателей
- См. также:
selected
public final BooleanProperty selectedProperty
- Определено:
-
selectedPropertyв интерфейсеToggle - Возвращает:
- свойство выбранного элемента
- См. также:
Подробное описание конструкторов
RadioMenuItem
public RadioMenuItem()
RadioMenuItem
public RadioMenuItem(String text)
- Параметры:
-
text- текст отображения
RadioMenuItem
public RadioMenuItem(String text, Node graphic)
Node для данного узла.- Параметры:
-
text- текст отображения -
graphic- графический узел
Подробное описание методов
setToggleGroup
public final void setToggleGroup(ToggleGroup value)
toggleGroup.- Определено:
-
setToggleGroupв интерфейсеToggle - Описание свойства:
- Представляет
ToggleGroup, к которому принадлежит эта RadioMenuItem. - Параметры:
-
value- значение для свойстваtoggleGroup - См. также:
getToggleGroup
public final ToggleGroup getToggleGroup()
toggleGroup.- Определено:
-
getToggleGroupв интерфейсеToggle - Описание свойства:
- Представляет
ToggleGroup, к которому принадлежит эта RadioMenuItem. - Возвращает:
- значение свойства
toggleGroup - См. также:
toggleGroupProperty
public final ObjectProperty<ToggleGroup> toggleGroupProperty()
ToggleGroup, к которому принадлежит эта RadioMenuItem.- Определено:
-
toggleGroupPropertyв интерфейсеToggle - Возвращает:
- свойство
toggleGroup - См. также:
setSelected
public final void setSelected(boolean value)
selected.- Определено:
-
setSelectedв интерфейсеToggle - Описание свойства:
- Параметры:
-
value- значение для свойстваselected - См. также:
isSelected
public final boolean isSelected()
selected.- Определено:
-
isSelectedв интерфейсеToggle - Описание свойства:
- Возвращает:
- значение свойства
selected - См. также:
selectedProperty
public final BooleanProperty selectedProperty()
ToggleToggle.- Определено:
-
selectedPropertyв интерфейсеToggle - Возвращает:
- свойство
selected - См. также:
© 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.