Module java.desktop

Package javax.swing

Class JToggleButton

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.AbstractButton

javax.swing.JToggleButton

所有已实现的接口:

ImageObserver, ItemSelectable, MenuContainer, Serializable, Accessible, SwingConstants

直接已知的子类:

JCheckBox, JRadioButton

       @JavaBean(defaultProperty="UIClassID", description="An implementation of a two-state button.") public class JToggleButton extends AbstractButton implements Accessible
      

一个两状态按钮的实现。JRadioButton 和 JCheckBox 类是这个类的子类。有关如何使用它们的信息，请参阅如何使用按钮、复选框和单选按钮，这是Java教程中的一个部分。

按钮可以通过Action进行配置和控制。使用Action与按钮有许多好处，超出了直接配置按钮。有关更多详细信息，请参阅支持Action的Swing组件，您可以在Java教程的如何使用Actions部分找到更多信息。

警告: Swing 不是线程安全的。有关更多信息，请参阅Swing的线程策略。

警告: 该类的序列化对象将不兼容未来的Swing版本。当前的序列化支持适用于短期存储或在运行相同Swing版本的应用程序之间的RMI。从1.4开始，已将所有JavaBeans的长期存储支持添加到java.beans包中。请参阅XMLEncoder。

自1.2版本起:

1.2

另请参阅:

• JRadioButton
• JCheckBox

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected class	JToggleButton.AccessibleJToggleButton	该类实现了JToggleButton类的辅助功能支持。
static class	JToggleButton.ToggleButtonModel	切换按钮模型

Nested classes/interfaces declared in class javax.swing.AbstractButton

AbstractButton.AccessibleAbstractButton, AbstractButton.ButtonChangeListener

Nested classes/interfaces declared in class javax.swing.JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces declared in class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces declared in class java.awt.Component

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

Field Summary

Fields declared in 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 declared in class javax.swing.JComponent

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

Fields declared in class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields declared in interface java.awt.image.ImageObserver

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

Fields declared in 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

Constructors

Constructor	Description
JToggleButton()	创建一个初始未选中的切换按钮，而不设置文本或图像。
JToggleButton(String text)	创建一个带有指定文本的未选中切换按钮。
JToggleButton(String text, boolean selected)	创建一个带有指定文本和选择状态的切换按钮。
JToggleButton(String text, Icon icon)	创建一个具有指定文本和图像的切换按钮，初始状态为未选中。
JToggleButton(String text, Icon icon, boolean selected)	创建一个带有指定文本、图像和选择状态的切换按钮。
JToggleButton(Action a)	从提供的Action创建一个初始未选中的切换按钮。
JToggleButton(Icon icon)	创建一个初始未选中的切换按钮，带有指定图像但没有文本。
JToggleButton(Icon icon, boolean selected)	创建一个带有指定图像和选择状态但没有文本的切换按钮。

Method Summary

Modifier and Type	Method	Description
AccessibleContext	getAccessibleContext()	获取与此JToggleButton关联的AccessibleContext。
String	getUIClassID()	返回一个字符串，指定渲染此组件的l&f类的名称。
protected String	paramString()	返回此JToggleButton的字符串表示形式。
void	requestFocus(FocusEvent.Cause cause)	如果此切换按钮是ButtonGroup的成员，该组有另一个已选中的切换按钮并且可以成为焦点所有者，并且焦点原因参数表示窗口激活或任何方向的焦点遍历操作，则方法执行的结果与在组中选中的切换按钮上调用Component.requestFocus(FocusEvent.Cause)相同。
boolean	requestFocusInWindow(FocusEvent.Cause cause)	如果此切换按钮是ButtonGroup的成员，该组有另一个已选中的切换按钮并且可以成为焦点所有者，并且焦点原因参数表示窗口激活或任何方向的焦点遍历操作，则方法执行的结果与在组中选中的切换按钮上调用Component.requestFocusInWindow(FocusEvent.Cause)相同。
void	updateUI()	将UI属性重置为当前外观的值。

Methods declared in class 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

Methods declared in class 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, 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

Methods declared in 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, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, transferFocusDownCycle, validate, validateTree

Methods declared in 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, 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

Methods declared in class java.lang.Object

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

Constructor Details

JToggleButton

             public JToggleButton()
            

创建一个初始未选中的切换按钮，而不设置文本或图像。

JToggleButton

             public JToggleButton(Icon icon)
            

创建一个初始未选中的切换按钮，带有指定图像但没有文本。

参数:

icon - 按钮应显示的图像

JToggleButton

             public JToggleButton(Icon icon, boolean selected)
            

创建一个带有指定图像和选择状态但没有文本的切换按钮。

参数:

icon - 按钮应显示的图像

selected - 如果为true，则按钮最初被选中；否则，按钮最初未选中

JToggleButton

             public JToggleButton(String text)
            

创建一个带有指定文本的未选中切换按钮。

参数:

text - 显示在切换按钮上的字符串

JToggleButton

             public JToggleButton(String text, boolean selected)
            

创建一个带有指定文本和选择状态的切换按钮。

参数:

text - 显示在切换按钮上的字符串

selected - 如果为true，则按钮最初被选中；否则，按钮最初未选中

JToggleButton

             public JToggleButton(Action a)
            

从提供的Action创建一个切换按钮。

参数:

a - Action的一个实例

自1.3版本起:

1.3

JToggleButton

             public JToggleButton(String text, Icon icon)
            

创建一个具有指定文本和图像的切换按钮，初始状态为未选中。

参数:

text - 按钮上显示的字符串

icon - 按钮应显示的图像

JToggleButton

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

创建一个带有指定文本、图像和选择状态的切换按钮。

参数:

text - 切换按钮的文本

icon - 按钮应显示的图像

selected - 如果为true，则按钮最初被选中；否则，按钮最初未选中

Method Details

updateUI

             public void updateUI()
            

将UI属性重置为当前外观的值。

覆盖:

updateUI 在类 AbstractButton中

另请参阅:

• JComponent.updateUI()

getUIClassID

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

返回一个字符串，指定渲染此组件的l&f类的名称。

覆盖:

getUIClassID 在类 JComponent中

返回:

字符串"ToggleButtonUI"

另请参阅:

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

requestFocus

             public void requestFocus(FocusEvent.Cause cause)
            

如果此切换按钮是ButtonGroup的成员，该组有另一个已选中的切换按钮并且可以成为焦点所有者，并且焦点原因参数表示窗口激活或任何方向的焦点遍历操作，则方法执行的结果与在组中选中的切换按钮上调用Component.requestFocus(FocusEvent.Cause)相同。在所有其他情况下，方法的结果与在此切换按钮上调用Component.requestFocus(FocusEvent.Cause)相同。

覆盖:

requestFocus 在类 Component中

参数:

cause - 请求焦点的原因

自9版本起:

9

另请参阅:

• ButtonGroup
• Component.requestFocus(FocusEvent.Cause)
• FocusEvent.Cause

requestFocusInWindow

             public boolean requestFocusInWindow(FocusEvent.Cause cause)
            

如果此切换按钮是ButtonGroup的成员，该组有另一个已选中的切换按钮并且可以成为焦点所有者，并且焦点原因参数表示窗口激活或任何方向的焦点遍历操作，则方法执行的结果与在组中选中的切换按钮上调用Component.requestFocusInWindow(FocusEvent.Cause)相同。在所有其他情况下，方法的结果与在此切换按钮上调用Component.requestFocusInWindow(FocusEvent.Cause)相同。

覆盖：

requestFocusInWindow 在类 Component中

参数：

cause - 请求焦点的原因

返回：

如果焦点更改请求肯定会失败，则返回false; 如果可能成功，则返回true

自：

9

参见：

• ButtonGroup
• Component.requestFocusInWindow(FocusEvent.Cause)
• FocusEvent.Cause

paramString

             protected String paramString()
            

返回此JToggleButton的字符串表示形式。此方法仅用于调试目的，返回的字符串的内容和格式可能因实现而异。返回的字符串可能为空，但不会是null。

覆盖：

paramString 在类 AbstractButton中

返回：

此JToggleButton的字符串表示形式。

getAccessibleContext

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

获取与此JToggleButton关联的AccessibleContext。对于切换按钮，AccessibleContext采用AccessibleJToggleButton的形式。如有必要，将创建一个新的AccessibleJToggleButton实例。

指定者：

getAccessibleContext 在接口 Accessible中

覆盖：

getAccessibleContext 在类 Component中

返回：

作为此JToggleButton的AccessibleContext的AccessibleJToggleButton