- 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(new EventHandler<ActionEvent>() { @Override public void handle(ActionEvent e) { System.out.println("radio toggled"); } });Проблема с приведенным выше примером в том, что он не предлагает никаких преимуществ по сравнению с использованием обычного MenuItem. Как уже упоминалось, назначение RadioMenuItem — предоставить пользователю несколько вариантов и разрешить выбор только одного из них (т. е. выбор должен быть взаимоисключающим). Для достижения этого вы можете поместить ноль или более RadioMenuItem в группы. При группировании одновременно может быть выбран только один RadioMenuItem в пределах этой группы. Чтобы поместить два экземпляра RadioMenuItem в одну группу, просто присвойте им оба одно и то же значение для
toggleGroup. Например:
В этом примере, с обоими RadioMenuItem, присвоенными одной и той жеToggleGroup toggleGroup = new ToggleGroup(); RadioMenuItem radioItem1 = new RadioMenuItem("Option 1"); radioItem.setOnAction(new EventHandler<ActionEvent>() { @Override public void handle(ActionEvent e) { System.out.println("radio toggled"); } }); radioItem1.setToggleGroup(toggleGroup); RadioMenuItem radioItem2 = new RadioMenuItem("Option 2"); radioItem.setOnAction(new EventHandler<ActionEvent>() { @Override public void handle(ActionEvent e) { System.out.println("radio toggled"); } }); radioItem2.setToggleGroup(toggleGroup);ToggleGroup, может быть выбран только один элемент за раз, и при изменении выбора группа ToggleGroup позаботится о снятии выделения с предыдущего элемента.
-
Сводка по свойствам
Свойства Тип Свойство Описание BooleanPropertyselectedСостояние выбора для данногоToggle.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для заданного узла.
-
Сводка по методам
Все методыМетодыКонкретные методы Модификатор и тип Метод Описание ToggleGroupgetToggleGroup()Получает значение свойства toggleGroup.booleanisSelected()Получает значение свойства selected.BooleanPropertyselectedProperty()Состояние выбора для данногоToggle.voidsetSelected(boolean value)Устанавливает значение свойства selected.voidsetToggleGroup(ToggleGroup value)Устанавливает значение свойства toggleGroup.ObjectProperty<ToggleGroup>toggleGroupProperty()ПредставляетToggleGroup, к которому принадлежит RadioMenuItem.-
Методы, унаследованные от класса javafx.scene.control.MenuItem
acceleratorProperty, addEventHandler, buildEventDispatchChain, disableProperty, fire, getAccelerator, getCssMetaData, getGraphic, getId, getOnAction, getOnMenuValidation, getParentMenu, getParentPopup, getProperties, getPseudoClassStates, getStyle, getStyleableNode, getStyleableParent, getStyleClass, getText, getTypeSelector, getUserData, graphicProperty, idProperty, isDisable, isMnemonicParsing, isVisible, mnemonicParsingProperty, onActionProperty, onMenuValidationProperty, parentMenuProperty, parentPopupProperty, removeEventHandler, setAccelerator, setDisable, setGraphic, setId, setMnemonicParsing, setOnAction, setOnMenuValidation, setParentMenu, setParentPopup, setStyle, setText, setUserData, setVisible, styleProperty, textProperty, toString, visibleProperty
-
Методы, унаследованные от класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Методы, унаследованные от интерфейса javafx.scene.control.Toggle
getProperties, getUserData, setUserData
-
-
Подробное описание свойств
-
toggleGroup
public final ObjectProperty<ToggleGroup> toggleGroupProperty
ПредставляетToggleGroup, к которому относится этот элемент RadioMenuItem.- Указано:
-
toggleGroupPropertyв интерфейсеToggle - См. также:
-
getToggleGroup(),setToggleGroup(ToggleGroup)
-
selected
public final BooleanProperty selectedProperty
- Указано:
-
selectedPropertyв интерфейсеToggle - См. также:
-
isSelected(),setSelected(boolean)
-
-
Подробное описание конструкторов
-
RadioMenuItem
public RadioMenuItem()
Создает RadioMenuItem без текста отображения.
-
RadioMenuItem
public RadioMenuItem(String text)
Создает RadioMenuItem и устанавливает текст отображения заданным текстом.- Параметры:
-
text- текст отображения
-
-
Подробное описание методов
-
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, к которому принадлежит этотToggle.
-
toggleGroupProperty
public final ObjectProperty<ToggleGroup> toggleGroupProperty()
ПредставляетToggleGroup, к которому относится этот RadioMenuItem.- Указано:
-
toggleGroupPropertyв интерфейсеToggle - См. также:
-
getToggleGroup(),setToggleGroup(ToggleGroup)
-
setSelected
public final void setSelected(boolean value)
Устанавливает значение свойства selected.- Указано:
-
setSelectedв интерфейсеToggle - Описание свойства:
- Параметры:
-
value- значение, чтобы сделать этотToggleвыбранным.
-
isSelected
public final boolean isSelected()
Получает значение свойства selected.- Указано:
-
isSelectedв интерфейсеToggle - Описание свойства:
- Возвращает:
-
true, если этотToggleвыбран.
-
selectedProperty
public final BooleanProperty selectedProperty()
Описание скопировано из интерфейса:ToggleСостояние выбора для этогоToggle.- Указано:
-
selectedPropertyв интерфейсеToggle - См. также:
-
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.