javax.swing
類別 JRadioButton

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.AbstractButton
                  javax.swing.JToggleButton
                      javax.swing.JRadioButton

所有已實作的介面：

ImageObserver, ItemSelectable, MenuContainer, Serializable, Accessible, SwingConstants

public class JRadioButton
extends JToggleButton
implements Accessible

實作一個單選按鈕，此按鈕項可被選擇或取消選擇，並可為使用者顯示其狀態。與 ButtonGroup 物件配合使用可創建一組按鈕，一次只能選擇其中的一個按鈕。（創建一個 ButtonGroup 物件並用其 add 方法將 JRadioButton 物件包含在此組中。）

註：ButtonGroup 物件為邏輯分組，不是物理分組。要創建按鈕面板，仍需要創建一個 JPanel 或類似的容器對象並將 Border 添加到其中以便將面板與周圍的元件分開。

通過 Action 可以配置按鈕，並進行一定程度的控制。對按鈕使用 Action 有許多直接配置按鈕所不及的優點。有關更多資訊，請參閱支持 Action 的 Swing 元件，可以在 The Java Tutorial 中的 How to Use Actions 一節找到更多資訊。

有關更多內容，請參閱 The Java Tutorial 中的 How to Use Buttons, Check Boxes, and Radio Buttons。

警告：Swing 不是執行緒安全的。有關更多資訊，請參閱 Swing's Threading Policy。

警告：此類別的序列化物件與以後的 Swing 版本不相容。當前序列化支持適用於短期存儲，或適用於在運行相同 Swing 版本的應用程序之間進行 RMI（Remote Method Invocation，遠端方法調用）。從 1.4 版本開始，已在 java.beans 套件中添加了支持所有 JavaBeans^TM 長期存儲的功能。請參見 XMLEncoder。

另請參見：

ButtonGroup, JCheckBox

巢狀類別摘要

protected class

JRadioButton.AccessibleJRadioButton 此類別實作對 JRadioButton 類別的可存取性支持。

從類別 javax.swing.JToggleButton 繼承的巢狀類別/介面

JToggleButton.AccessibleJToggleButton, JToggleButton.ToggleButtonModel

從類別 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 繼承的欄位

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

從類別 java.awt.Component 繼承的欄位

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

從介面 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

從介面 java.awt.image.ImageObserver 繼承的欄位

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

建構子摘要

JRadioButton()
創建一個初始化為未選擇的單選按鈕，其文本未設定。

JRadioButton(Action a)
創建一個單選按鈕，其屬性來自提供的 Action。

JRadioButton(Icon icon)
創建一個初始化為未選擇的單選按鈕，其具有指定的圖像但無文本。

JRadioButton(Icon icon, boolean selected)
創建一個具有指定圖像和選擇狀態的單選按鈕，但無文本。

JRadioButton(String text)
創建一個具有指定文本的狀態為未選擇的單選按鈕。

JRadioButton(String text, boolean selected)
創建一個具有指定文本和選擇狀態的單選按鈕。

JRadioButton(String text, Icon icon)
創建一個具有指定的文本和圖像並初始化為未選擇的單選按鈕。

JRadioButton(String text, Icon icon, boolean selected)
創建一個具有指定的文本、圖像和選擇狀態的單選按鈕。

方法摘要

AccessibleContext	getAccessibleContext() 獲取與此 JRadioButton 相關聯的 AccessibleContext。
String	getUIClassID() 返回呈現此元件的 L&F 類別的名稱。
protected String	paramString() 返回此 JRadioButton 的字元串表示形式。
void	updateUI() 將 UI 屬性重置為當前外觀對應的值。

從類別 javax.swing.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

從類別 javax.swing.JComponent 繼承的方法

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, 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, 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, transferFocusBackward, 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, 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, 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, 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, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle

從類別 java.lang.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。

從以下版本開始：

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 - 此按鈕應顯示的圖像

方法詳細資訊

updateUI

public void updateUI()

將 UI 屬性重置為當前外觀對應的值。

覆寫：

類別 JToggleButton 中的 updateUI

另請參見：

JComponent.updateUI()

getUIClassID

public String getUIClassID()

返回呈現此元件的 L&F 類別的名稱。

覆寫：

類別 JToggleButton 中的 getUIClassID

返回：

"RadioButtonUI" 字元串

另請參見：

JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

paramString

protected String paramString()

返回此 JRadioButton 的字元串表示形式。此方法僅在進行除錯的時候使用，對於各個實作，所返回字元串的內容和格式可能有所不同。返回的字元串可能為空，但不可能為 null。

覆寫：

類別 JToggleButton 中的 paramString

返回：

此 JRadioButton 的字元串表示形式。

getAccessibleContext

public AccessibleContext getAccessibleContext()

獲取與此 JRadioButton 相關聯的 AccessibleContext。對於 JRadioButton，AccessibleContext 採用 AccessibleJRadioButton 的形式。必要時創建新的 AccessibleJRadioButton 實例。

指定者：

介面 Accessible 中的 getAccessibleContext

覆寫：

類別 JToggleButton 中的 getAccessibleContext

返回：

一個 AccessibleJRadioButton，它將充當此 JRadioButton 的 AccessibleContext