Класс JRadioButton

javax.swing.JRadioButton

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

@JavaBean(description="A component which can display it's state as selected or deselected.") public class JRadioButton extends JToggleButton implements Accessible

Реализация переключателя — элемента, который можно выбрать или отменить его выбор и который отображает свое состояние пользователю. Используется с объектом ButtonGroup для создания группы кнопок, в которой одновременно может быть выбрана только одна кнопка. (Создайте объект ButtonGroup и используйте его метод add, чтобы включить объекты JRadioButton в группу.)

Примечание: Объект ButtonGroup представляет собой логическую группировку, а не физическую. Чтобы создать панель кнопок, все равно следует создать JPanel или аналогичный контейнер и добавить к нему Border, чтобы визуально отделить его от окружающих компонентов.

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

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

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

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

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

1.2

См. также:

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

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

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

JToggleButton.AccessibleJToggleButton, JToggleButton.ToggleButtonModel

Вложенные классы и интерфейсы, объявленные в классе 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

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

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

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

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

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

requestFocus, requestFocusInWindow

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

actionPropertyChanged, addActionListener, addChangeListener, addImpl, addItemListener, checkHorizontalKey, checkVerticalKey, configurePropertiesFromAction, 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, init, isBorderPainted, isContentAreaFilled, isFocusPainted, isRolloverEnabled, isSelected, paintBorder, removeActionListener, removeChangeListener, removeItemListener, removeNotify, setAction, setActionCommand, setBorderPainted, setContentAreaFilled, setDisabledIcon, setDisabledSelectedIcon, setDisplayedMnemonicIndex, setEnabled, setFocusPainted, setHideActionText, setHorizontalAlignment, setHorizontalTextPosition, setIcon, setIconTextGap, setLabel, setLayout, setMargin, setMnemonic, setMnemonic, setModel, 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, 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

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

JRadioButton

public JRadioButton()

Создает изначально невыбранный переключатель без заданного текста.

JRadioButton

public JRadioButton(Icon icon)

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

Параметры:: icon — изображение, которое должна отображать кнопка

JRadioButton

public JRadioButton(Action a)

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

Параметры:: a — объект Action
Начиная с версии:: 1.3

JRadioButton

public JRadioButton(Icon icon, boolean selected)

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

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

JRadioButton

public JRadioButton(String text)

Создает невыбранный переключатель с указанным текстом.

Параметры:: text — строка, отображаемая на переключателе

JRadioButton

public JRadioButton(String text, boolean selected)

Создает переключатель с указанным текстом и состоянием выбора.

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

JRadioButton

public JRadioButton(String text, Icon icon)

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

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

JRadioButton

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

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

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

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

updateUI

public void updateUI()

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

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

updateUI в классе JToggleButton

См. также:

getUIClassID

@BeanProperty(bound=false, expert=true, description="A string that specifies the name of the L&F class.") public String getUIClassID()

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

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

getUIClassID в классе JToggleButton

Возвращает:

строку "RadioButtonUI"

См. также:

paramString

protected String paramString()

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

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

getAccessibleContext

@BeanProperty(bound=false, expert=true, description="The AccessibleContext associated with this Button") public AccessibleContext getAccessibleContext()

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

Определено в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе JToggleButton
Возвращает:: объект AccessibleJRadioButton, выполняющий роль AccessibleContext этого JRadioButton

© 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/JRadioButton.html