Spec-Zone.ru › OpenJavaFX 24

Класс 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 и/или его дочерние компании. Все права защищены.

© 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