Класс JRadioButtonMenuItem

javax.swing.JRadioButtonMenuItem

Все реализованные интерфейсы:: ImageObserver, ItemSelectable, MenuContainer, Serializable, Accessible, MenuElement, SwingConstants

@JavaBean(description="A component within a group of menu items which can be selected.") public class JRadioButtonMenuItem extends JMenuItem implements Accessible

Реализация элемента меню с переключателем. JRadioButtonMenuItem — это элемент меню, являющийся частью группы элементов меню, в которой можно выбрать только один элемент. Выбранный элемент отображает свое выбранное состояние. Выбор элемента приводит к тому, что все остальные выбранные элементы переходят в невыбранное состояние. Для управления состоянием выбора группы элементов меню с переключателями используйте объект ButtonGroup.

Элементы меню можно настраивать и в некоторой степени контролировать с помощью Action. Использование Action с элементом меню дает множество преимуществ помимо непосредственной настройки элемента меню. Подробнее см. в разделе Компоненты Swing, поддерживающие Action. Дополнительные сведения см. в разделе Использование действий руководства Учебник по Java.

Некоторые меню могут содержать несколько групп переключателей. В этом случае желательно, чтобы щелчок по одному элементу меню с переключателем не закрывал меню. Такое поведение можно контролировать с помощью клиентского свойства JComponent.putClientProperty(Object, Object) или свойства Look and Feel UIManager.put(Object, Object) с именем "RadioButtonMenuItem.doNotCloseOnMouseClick". Значение по умолчанию — false. Если установить для свойства значение true, меню не будет закрываться при щелчке мышью. Если задано клиентское свойство, всегда используется его значение; в противном случае проверяется свойство L&F. Примечание: некоторые L&F могут игнорировать это свойство. Все встроенные L&F наследуют это поведение.

Дополнительную документацию и примеры см. в разделе Использование меню руководства Учебник по Java.

Предупреждение: Swing не является потокобезопасным. Дополнительные сведения см. в разделе Политика многопоточности Swing.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими версиями Swing. Текущая поддержка сериализации подходит для краткосрочного хранения или RMI между приложениями, работающими с одной и той же версией Swing. Начиная с версии 1.4 в пакете java.beans добавлена поддержка долгосрочного хранения всех JavaBeans. См. XMLEncoder.

Начиная с версии:

1.2

См. также:

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`protected class`	`JRadioButtonMenuItem.AccessibleJRadioButtonMenuItem`	Этот класс реализует поддержку специальных возможностей для класса `JRadioButtonMenuItem`.

Вложенные классы и интерфейсы, объявленные в классе JMenuItem

JMenuItem.AccessibleJMenuItem

Вложенные классы и интерфейсы, объявленные в классе AbstractButton

AbstractButton.AccessibleAbstractButton, AbstractButton.ButtonChangeListener

Вложенные классы и интерфейсы, объявленные в классе JComponent

JComponent.AccessibleJComponent

Вложенные классы и интерфейсы, объявленные в классе Container

Container.AccessibleAWTContainer

Вложенные классы и интерфейсы, объявленные в классе Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Краткое описание полей

Поля, объявленные в классе AbstractButton

actionListener, BORDER_PAINTED_CHANGED_PROPERTY, changeEvent, changeListener, CONTENT_AREA_FILLED_CHANGED_PROPERTY, DISABLED_ICON_CHANGED_PROPERTY, DISABLED_SELECTED_ICON_CHANGED_PROPERTY, FOCUS_PAINTED_CHANGED_PROPERTY, HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY, HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY, ICON_CHANGED_PROPERTY, itemListener, MARGIN_CHANGED_PROPERTY, MNEMONIC_CHANGED_PROPERTY, model, MODEL_CHANGED_PROPERTY, PRESSED_ICON_CHANGED_PROPERTY, ROLLOVER_ENABLED_CHANGED_PROPERTY, ROLLOVER_ICON_CHANGED_PROPERTY, ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY, SELECTED_ICON_CHANGED_PROPERTY, TEXT_CHANGED_PROPERTY, VERTICAL_ALIGNMENT_CHANGED_PROPERTY, VERTICAL_TEXT_POSITION_CHANGED_PROPERTY

Поля, объявленные в классе JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Поля, объявленные в классе Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, объявленные в интерфейсе ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Поля, объявленные в интерфейсе SwingConstants

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

Краткое описание конструкторов

Конструктор	Описание
`JRadioButtonMenuItem()`	Создает `JRadioButtonMenuItem` без заданного текста или значка.
`JRadioButtonMenuItem(String text)`	Создает `JRadioButtonMenuItem` с текстом.
`JRadioButtonMenuItem(String text, boolean selected)`	Создает элемент меню с переключателем, содержащий указанный текст и имеющий заданное состояние выбора.
`JRadioButtonMenuItem(String text, Icon icon)`	Создает элемент меню с переключателем, содержащий указанный текст и `Icon`.
`JRadioButtonMenuItem(String text, Icon icon, boolean selected)`	Создает элемент меню с переключателем, содержащий указанные текст и изображение и имеющий заданное состояние выбора.
`JRadioButtonMenuItem(Action a)`	Создает элемент меню с переключателем, свойства которого берутся из переданного `Action`.
`JRadioButtonMenuItem(Icon icon)`	Создает `JRadioButtonMenuItem` со значком.
`JRadioButtonMenuItem(Icon icon, boolean selected)`	Создает элемент меню с переключателем, содержащий указанное изображение и имеющий заданное состояние выбора, но без текста.

Краткое описание методов

Модификатор и тип	Метод	Описание
`AccessibleContext`	`getAccessibleContext()`	Возвращает AccessibleContext, связанный с этим JRadioButtonMenuItem.
`String`	`getUIClassID()`	Возвращает имя класса L&F, который отображает этот компонент.
`protected String`	`paramString()`	Возвращает строковое представление этого `JRadioButtonMenuItem`.

Методы, объявленные в классе JMenuItem

actionPropertyChanged, addMenuDragMouseListener, addMenuKeyListener, configurePropertiesFromAction, fireMenuDragMouseDragged, fireMenuDragMouseEntered, fireMenuDragMouseExited, fireMenuDragMouseReleased, fireMenuKeyPressed, fireMenuKeyReleased, fireMenuKeyTyped, getAccelerator, getComponent, getMenuDragMouseListeners, getMenuKeyListeners, getSubElements, init, isArmed, menuSelectionChanged, processKeyEvent, processMenuDragMouseEvent, processMenuKeyEvent, processMouseEvent, removeMenuDragMouseListener, removeMenuKeyListener, setAccelerator, setArmed, setEnabled, setModel, setUI, updateUI

Методы, объявленные в классе AbstractButton

addActionListener, addChangeListener, addImpl, addItemListener, checkHorizontalKey, checkVerticalKey, createActionListener, createActionPropertyChangeListener, createChangeListener, createItemListener, doClick, doClick, fireActionPerformed, fireItemStateChanged, fireStateChanged, getAction, getActionCommand, getActionListeners, getChangeListeners, getDisabledIcon, getDisabledSelectedIcon, getDisplayedMnemonicIndex, getHideActionText, getHorizontalAlignment, getHorizontalTextPosition, getIcon, getIconTextGap, getItemListeners, getLabel, getMargin, getMnemonic, getModel, getMultiClickThreshhold, getPressedIcon, getRolloverIcon, getRolloverSelectedIcon, getSelectedIcon, getSelectedObjects, getText, getUI, getVerticalAlignment, getVerticalTextPosition, imageUpdate, isBorderPainted, isContentAreaFilled, isFocusPainted, isRolloverEnabled, isSelected, paintBorder, removeActionListener, removeChangeListener, removeItemListener, removeNotify, setAction, setActionCommand, setBorderPainted, setContentAreaFilled, setDisabledIcon, setDisabledSelectedIcon, setDisplayedMnemonicIndex, setFocusPainted, setHideActionText, setHorizontalAlignment, setHorizontalTextPosition, setIcon, setIconTextGap, setLabel, setLayout, setMargin, setMnemonic, setMnemonic, setMultiClickThreshhold, setPressedIcon, setRolloverEnabled, setRolloverIcon, setRolloverSelectedIcon, setSelected, setSelectedIcon, setText, setUI, setVerticalAlignment, setVerticalTextPosition

Методы, объявленные в классе JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Методы, объявленные в классе Container

add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, transferFocusDownCycle, validate, validateTree

Методы, объявленные в классе Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Подробное описание конструкторов

JRadioButtonMenuItem

public JRadioButtonMenuItem()

Создает JRadioButtonMenuItem без заданного текста или значка.

JRadioButtonMenuItem

public JRadioButtonMenuItem(Icon icon)

Создает JRadioButtonMenuItem со значком.

Параметры:: icon — Icon для отображения на JRadioButtonMenuItem

JRadioButtonMenuItem

public JRadioButtonMenuItem(String text)

Создает JRadioButtonMenuItem с текстом.

Параметры:: text — текст JRadioButtonMenuItem

JRadioButtonMenuItem

public JRadioButtonMenuItem(Action a)

Создает элемент меню с переключателем, свойства которого берутся из переданного Action.

Параметры:: a — Action, на основе которого создается элемент меню с переключателем
Начиная с версии:: 1.3

JRadioButtonMenuItem

public JRadioButtonMenuItem(String text, Icon icon)

Создает элемент меню с переключателем, содержащий указанный текст и Icon.

Параметры:: text — текст JRadioButtonMenuItem; icon — значок для отображения на JRadioButtonMenuItem

JRadioButtonMenuItem

public JRadioButtonMenuItem(String text, boolean selected)

Создает элемент меню с переключателем, содержащий указанный текст и имеющий заданное состояние выбора.

Параметры:: text — текст CheckBoxMenuItem; selected — состояние выбора CheckBoxMenuItem

JRadioButtonMenuItem

public JRadioButtonMenuItem(Icon icon, boolean selected)

Создает элемент меню с переключателем, содержащий указанное изображение и имеющий заданное состояние выбора, но без текста.

Параметры:: icon — изображение, которое должна отображать кнопка; selected — если значение равно true, кнопка изначально выбрана; в противном случае кнопка изначально не выбрана

JRadioButtonMenuItem

public JRadioButtonMenuItem(String text, Icon icon, boolean selected)

Создает элемент меню с переключателем, содержащий указанные текст и изображение и имеющий заданное состояние выбора. Все остальные конструкторы делегируют вызов этому конструктору.

Параметры:: text — строка, отображаемая на переключателе; icon — изображение, которое должна отображать кнопка; selected — если true, кнопка изначально выбрана; в противном случае кнопка изначально не выбрана

Подробное описание методов

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()

Возвращает имя класса L&F, который отображает этот компонент.

Переопределяет:

getUIClassID в классе JMenuItem

Возвращает:

строку "RadioButtonMenuItemUI"

См. также:

paramString

protected String paramString()

Возвращает строковое представление этого JRadioButtonMenuItem. Этот метод предназначен только для отладки, а содержимое и формат возвращаемой строки могут различаться в разных реализациях. Возвращаемая строка может быть пустой, но не может быть null.

Переопределяет:: paramString в классе JMenuItem
Возвращает:: строковое представление этого JRadioButtonMenuItem

getAccessibleContext

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()

Возвращает AccessibleContext, связанный с этим JRadioButtonMenuItem. Для JRadioButtonMenuItem объект AccessibleContext имеет тип AccessibleJRadioButtonMenuItem. При необходимости создается новый экземпляр AccessibleJRadioButtonMenuItem.

Определено в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе JMenuItem
Возвращает:: объект AccessibleJRadioButtonMenuItem, служащий AccessibleContext этого JRadioButtonMenuItem

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/JRadioButtonMenuItem.html