Класс 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(java.lang.Object, java.lang.Object) или свойство внешнего вида и ощущений UIManager.put(java.lang.Object, java.lang.Object) с именем "RadioButtonMenuItem.doNotCloseOnMouseClick". Значение по умолчанию — false. Установка свойства на true предотвращает закрытие меню при нажатии на него мышкой. Если свойство клиента установлено, его значение всегда используется; в противном случае запрашивается свойство внешнего вида и ощущений. Примечание: некоторые L&F могут игнорировать это свойство. Все встроенные L&F наследуют это поведение.

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

Предупреждение: Swing не потокобезопасен. Дополнительную информацию см. в разделе Политика потоков Swing.

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

С тех пор:
1.2
См. также:
ButtonGroup, Сериализованная форма

Вложенные классы

Модификатор и тип Класс Описание
protected class  JRadioButtonMenuItem.AccessibleJRadioButtonMenuItem

Этот класс реализует поддержку доступности для класса JRadioButtonMenuItem.

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

JMenuItem.AccessibleJMenuItem

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

AbstractButton.AccessibleAbstractButton, AbstractButton.ButtonChangeListener

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

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

Поля

Поля, объявленные в классе javax.swing.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

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

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

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

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

Поля, объявленные в интерфейсе javax.swing.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.

Методы, объявленные в классе javax.swing.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, setUI, updateUI

Методы, объявленные в классе javax.swing.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, setModel, setMultiClickThreshhold, setPressedIcon, setRolloverEnabled, setRolloverIcon, setRolloverSelectedIcon, setSelected, setSelectedIcon, setText, setUI, setVerticalAlignment, setVerticalTextPosition

Методы, объявленные в классе javax.swing.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, 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

Методы, объявленные в классе java.awt.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

Методы, объявленные в классе java.awt.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, hide, 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

Методы, объявленные в классе java.lang.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"
См. также:
JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

paramString

protected String paramString()

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

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

getAccessibleContext

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

Получает AccessibleContext, связанный с этим JRadioButtonMenuItem. Для JRadioButtonMenuItems AccessibleContext принимает вид AccessibleJRadioButtonMenuItem. Новый экземпляр AccessibleJRadioButtonMenuItem создаётся при необходимости.

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

© 1993, 2020, 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/11/docs/api/java.desktop/javax/swing/JRadioButtonMenuItem.html

Spec-Zone .ru
спецификации, руководства, описания, API