Spec-Zone.ru › OpenJavaFX 11
Модуль javafx.controls
Пакет javafx.scene.control

Класс 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(new EventHandler<ActionEvent>() {
        @Override public void handle(ActionEvent e) {
            System.out.println("radio toggled");
        }
    });
    

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

    
    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);
    
    
    В этом примере, с обоими RadioMenuItem, присвоенными одной и той же ToggleGroup, может быть выбран только один элемент за раз, и при изменении выбора группа ToggleGroup позаботится о снятии выделения с предыдущего элемента.
    С момента:
    JavaFX 2.0
    См. также:
    MenuItem, Menu
  • Сводка по свойствам

    Свойства
    Тип Свойство Описание
    BooleanProperty selected
    Состояние выбора для данного 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 для заданного узла.
  • Сводка по методам

    Все методыМетодыКонкретные методы
    Модификатор и тип Метод Описание
    ToggleGroup getToggleGroup()
    Получает значение свойства toggleGroup.
    boolean isSelected()
    Получает значение свойства selected.
    BooleanProperty selectedProperty()
    Состояние выбора для данного Toggle.
    void setSelected​(boolean value)
    Устанавливает значение свойства selected.
    void setToggleGroup​(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 - текст отображения
    • 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

      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.

Spec-Zone.ru

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