Spec-Zone.ru › OpenJavaFX 8
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, 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 и устанавливает текст отображения указанным текстом.
    • RadioMenuItem

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

    • 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 — true, чтобы сделать этот 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