javax.swing
Class JRadioButton
java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.AbstractButton
javax.swing.JToggleButton
javax.swing.JRadioButton
- All Implemented Interfaces:
- ImageObserver, ItemSelectable, MenuContainer, Serializable, Accessible, SwingConstants
public class JRadioButton
- extends JToggleButton
The JRadioButton
component provides a visually selectable
button with mutually exclusive behaviour within a ButtonGroup
.
A series of radio buttons can be used to provide options to the user,
where the user can only select one of the available options. The state
of the button is provided by the superclass, JToggleButton
.
JRadioButton
adds the additional behaviour, that if two
or more radio buttons are grouped together, the selection of one implies
the deselection of the other buttons within the group.
Buttons are grouped by adding each instance to a ButtonGroup
.
The existence of such a grouping is not reflected visually, so other means
should be used to denote this. For instance, the grouped buttons can be placed
within the same panel, possibly with an appropriate border to denote
the connection between the components.
- Since:
- 1.2
- See Also:
JToggleButton
,
ButtonGroup
,
Serialized Form
Fields inherited from class 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 |
Fields inherited from interface 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 |
Constructor Summary |
JRadioButton()
Constructs an unselected radio button with no text or icon. |
JRadioButton(Action a)
Constructs a radio button using the labelling, state
and icon specified by the supplied action. |
JRadioButton(Icon icon)
Constructs an unselected radio button with the supplied icon
and no text. |
JRadioButton(Icon icon,
boolean selected)
Constructs a radio button with the supplied icon and state. |
JRadioButton(String text)
Constructs an unselected radio button using the supplied text
and no icon. |
JRadioButton(String text,
boolean selected)
Constructs a radio button with the supplied text and state. |
JRadioButton(String text,
Icon icon)
Constructs an unselected radio button with the supplied text
and icon. |
JRadioButton(String text,
Icon icon,
boolean selected)
Constructs a radio button with the supplied text, icon and state. |
Method Summary |
AccessibleContext |
getAccessibleContext()
Returns the accessible context for this JRadioButton ,
in the form of an instance of AccessibleJRadioButton . |
String |
getUIClassID()
Returns a string specifying the name of the Look and Feel UI class
that renders this component. |
protected String |
paramString()
Returns a string representation of this component for debugging use. |
void |
updateUI()
This method resets the radio button's UI delegate to the default UI for
the current look and feel. |
Methods inherited from class javax.swing.AbstractButton |
addActionListener, addChangeListener, addImpl, addItemListener, checkHorizontalKey, checkVerticalKey, configurePropertiesFromAction, createActionListener, createActionPropertyChangeListener, createChangeListener, createItemListener, doClick, doClick, fireActionPerformed, fireItemStateChanged, fireStateChanged, getAction, getActionCommand, getActionListeners, getChangeListeners, getDisabledIcon, getDisabledSelectedIcon, getDisplayedMnemonicIndex, 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, setAction, setActionCommand, setBorderPainted, setContentAreaFilled, setDisabledIcon, setDisabledSelectedIcon, setDisplayedMnemonicIndex, setEnabled, setFocusPainted, setHorizontalAlignment, setHorizontalTextPosition, setIcon, setIconTextGap, setLabel, setLayout, setMargin, setMnemonic, setMnemonic, setModel, setMultiClickThreshhold, setPressedIcon, setRolloverEnabled, setRolloverIcon, setRolloverSelectedIcon, setSelected, setSelectedIcon, setText, setUI, setVerticalAlignment, setVerticalTextPosition |
Methods inherited from class javax.swing.JComponent |
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setNextFocusableComponent, setOpaque, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update |
Methods inherited from class 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, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, transferFocusDownCycle, validate, validateTree |
Methods inherited from class 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, getFontMetrics, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, 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, processMouseEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle |
JRadioButton
public JRadioButton()
- Constructs an unselected radio button with no text or icon.
JRadioButton
public JRadioButton(Action a)
- Constructs a radio button using the labelling, state
and icon specified by the supplied action.
- Parameters:
a
- the action to use to define the properties of the button.
JRadioButton
public JRadioButton(Icon icon)
- Constructs an unselected radio button with the supplied icon
and no text.
- Parameters:
icon
- the icon to use.
JRadioButton
public JRadioButton(Icon icon,
boolean selected)
- Constructs a radio button with the supplied icon and state.
- Parameters:
icon
- the icon to use.selected
- if true, the radio button is initially in the
selected state. Otherwise, the button is unselected.
JRadioButton
public JRadioButton(String text)
- Constructs an unselected radio button using the supplied text
and no icon.
- Parameters:
text
- the text to use.
JRadioButton
public JRadioButton(String text,
boolean selected)
- Constructs a radio button with the supplied text and state.
- Parameters:
text
- the text to use.selected
- if true, the radio button is initially in the
selected state. Otherwise, the button is unselected.
JRadioButton
public JRadioButton(String text,
Icon icon)
- Constructs an unselected radio button with the supplied text
and icon.
- Parameters:
text
- the text to use.icon
- the icon to use.
JRadioButton
public JRadioButton(String text,
Icon icon,
boolean selected)
- Constructs a radio button with the supplied text, icon and state.
- Parameters:
text
- the text to use.icon
- the icon to use.selected
- if true, the radio button is initially in the
selected state. Otherwise, the button is unselected.
getAccessibleContext
public AccessibleContext getAccessibleContext()
- Returns the accessible context for this
JRadioButton
,
in the form of an instance of AccessibleJRadioButton
.
The context is created, if necessary.
- Specified by:
getAccessibleContext
in interface Accessible
- Overrides:
getAccessibleContext
in class JToggleButton
- Returns:
- the associated context
getUIClassID
public String getUIClassID()
- Returns a string specifying the name of the Look and Feel UI class
that renders this component.
- Overrides:
getUIClassID
in class JToggleButton
- Returns:
- the Look and Feel UI class for
JRadioButton
s
as a String
. - See Also:
JComponent.setUI(javax.swing.plaf.ComponentUI)
,
JComponent.updateUI()
paramString
protected String paramString()
- Returns a string representation of this component for debugging use.
Users should not depend on anything as regards the content or formatting
of this string, except for the fact that the returned string may never be
null (only empty).
- Overrides:
paramString
in class JToggleButton
- Returns:
- the component in
String
form for debugging.
updateUI
public void updateUI()
- This method resets the radio button's UI delegate to the default UI for
the current look and feel.
- Overrides:
updateUI
in class JToggleButton