模块 java.desktop

包 javax.swing

类 JButton

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.AbstractButton

javax.swing.JButton

所有已实现的接口：

ImageObserver , ItemSelectable , MenuContainer , Serializable , Accessible , SwingConstants

已知子类：

BasicArrowButton , MetalComboBoxButton

@JavaBean (defaultProperty ="UIClassID", description ="An implementation of a \"push\" button.") public class JButton extends AbstractButton implements Accessible 
      

“按下”按钮的实现。

按钮可以通过Actions 进行配置，并在某种程度上进行控制。使用带有按钮的 Action 比直接配置按钮有很多好处。有关详细信息，请参阅 摇摆组件支持Action，您可以在 如何使用动作 中找到更多信息，这是 The Java Tutorial 中的一个部分。

有关使用按钮的信息和示例，请参阅 The Java Tutorial 中的 如何使用按钮、复选框和单选按钮。

Warning: Swing 不是线程安全的。有关详细信息，请参阅 Swing 的线程策略。

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

自从：

1.2

内部类总结

内部类

修饰符和类型	类	描述
protected class	JButton.AccessibleJButton	此类实现了对 JButton 类的辅助功能支持。

在类 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

构造方法总结

构造方法

构造方法	描述
JButton()	创建一个没有设置文本或图标的按钮。
JButton(String text)	创建一个带有文本的按钮。
JButton(String text, Icon icon)	创建一个带有初始文本和图标的按钮。
JButton(Action a)	创建一个按钮，其中的属性取自所提供的 Action。
JButton(Icon icon)	创建一个带有图标的按钮。

方法总结

修饰符和类型	方法	描述
AccessibleContext	getAccessibleContext()	获取与此 JButton 关联的 AccessibleContext。
String	getUIClassID()	返回一个字符串，该字符串指定呈现此组件的 L&F 类的名称。
boolean	isDefaultButton()	获取 defaultButton 属性的值，如果 true 表示此按钮是其 JRootPane 的当前默认按钮。
boolean	isDefaultCapable()	获取 defaultCapable 属性的值。
protected String	paramString()	返回此 JButton 的字符串表示形式
void	removeNotify()	覆盖 JComponent.removeNotify 以检查此按钮当前是否设置为 RootPane 上的默认按钮，如果是，则将 RootPane 的默认按钮设置为 null 以确保 RootPane 不会保留无效按钮引用。
void	setDefaultCapable(boolean defaultCapable)	设置 defaultCapable 属性，该属性确定是否可以将此按钮设为其根窗格的默认按钮。
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, 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, 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

在类 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, 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

构造方法详细信息

JButton

public JButton()
            

创建一个没有设置文本或图标的按钮。

JButton

public JButton(Icon  icon)
            

创建一个带有图标的按钮。

参数：

icon - 显示在按钮上的图标图像

JButton

@ConstructorProperties ("text") public JButton(String  text)
            

创建一个带有文本的按钮。

参数：

text - 按钮的文字

JButton

public JButton(Action  a)
            

创建一个按钮，其中的属性取自所提供的 Action。

参数：

a - Action 用于指定新按钮

自从：

1.3

JButton

public JButton(String  text, Icon  icon)
            

创建一个带有初始文本和图标的按钮。

参数：

text - 按钮的文字

icon - 显示在按钮上的图标图像

方法详情

updateUI

public void updateUI()
            

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

重写：

updateUI 在类 AbstractButton 中

参见：

• JComponent.updateUI()

getUIClassID

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

返回一个字符串，该字符串指定呈现此组件的 L&F 类的名称。

重写：

getUIClassID 在类 JComponent 中

返回：

字符串“ButtonUI”

参见：

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

isDefaultButton

@BeanProperty (bound =false, description ="Whether or not this button is the default button") public boolean isDefaultButton()
            

获取 defaultButton 属性的值，如果 true 表示此按钮是其 JRootPane 的当前默认按钮。大多数外观以不同方式呈现默认按钮，并且可能提供绑定以访问默认按钮。

返回：

defaultButton 属性的值

参见：

• JRootPane.setDefaultButton(javax.swing.JButton)
• isDefaultCapable()

isDefaultCapable

public boolean isDefaultCapable()
            

获取 defaultCapable 属性的值。

返回：

defaultCapable 属性的值

参见：

• setDefaultCapable(boolean)
• isDefaultButton()
• JRootPane.setDefaultButton(javax.swing.JButton)

setDefaultCapable

@BeanProperty (visualUpdate =true, description ="Whether or not this button can be the default button") public void setDefaultCapable(boolean defaultCapable)
            

设置 defaultCapable 属性，该属性确定是否可以将此按钮设为其根窗格的默认按钮。 defaultCapable 属性的默认值为 true 除非外观另有指定。

参数：

defaultCapable - true 如果此按钮能够成为 RootPane 上的默认按钮；否则false

参见：

• isDefaultCapable()

removeNotify

public void removeNotify()
            

覆盖 JComponent.removeNotify 以检查此按钮当前是否设置为 RootPane 上的默认按钮，如果是，则将 RootPane 的默认按钮设置为 null 以确保 RootPane 不会保留无效按钮引用。

重写：

removeNotify 在类 AbstractButton 中

参见：

• JComponent.registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)

paramString

protected String  paramString()
            

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

重写：

paramString 在类 AbstractButton 中

返回：

这个 JButton 的字符串表示

getAccessibleContext

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

获取与此 JButton 关联的 AccessibleContext。对于 JButton s，AccessibleContext 采用 AccessibleJButton 的形式。如有必要，将创建一个新的 AccessibleJButton 实例。

指定者：

getAccessibleContext 在接口 Accessible 中

重写：

getAccessibleContext 在类 Component 中

返回：

一个 AccessibleJButton 作为这个 JButton 的 AccessibleContext