模块 java.desktop

软件包 javax.swing

Class 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 JButtonextends AbstractButtonimplements Accessible

“推”按钮的实现。

按钮可以通过Action配置，并在某种程度上受到控制。 使用带按钮的Action除了直接配置按钮外，还有许多其他好处。 有关更多详细信息，请参阅Swing Components Supporting Action ，您可以在Java教程的 How to Use Actions部分中找到更多信息。

有关使用按钮的信息和示例，请参阅The Java Tutorial中的 How to Use Buttons, Check Boxes, and Radio Buttons 。

警告： Swing不是线程安全的。 有关更多信息，请参阅Swing's Threading Policy 。

警告：此类的序列化对象与以后的Swing版本不兼容。 当前的序列化支持适用于运行相同版本Swing的应用程序之间的短期存储或RMI。 从1.4开始， java.beans软件包中添加了对所有JavaBeans java.beans长期存储的支持。 请参阅XMLEncoder 。

从以下版本开始：

1.2

另请参见：

Serialized Form

嵌套类汇总

嵌套类

变量和类型	类	描述
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

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

构造方法摘要

构造方法

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

方法摘要

变量和类型	方法	描述
AccessibleContext	getAccessibleContext()	获取与 AccessibleContext相关的 JButton 。
String	getUIClassID()	返回一个字符串，该字符串指定呈现此组件的L＆F类的名称。
boolean	isDefaultButton()	获取 defaultButton属性的值，如果 true表示此按钮是其 JRootPane的当前默认按钮，则该 JRootPane 。
boolean	isDefaultCapable()	获取 defaultCapable属性的值。
protected String	paramString()	返回此 JButton的字符串表示 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, 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, 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, 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的当前默认按钮，则该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的字符串表示JButton 。 此方法仅用于调试目的，返回字符串的内容和格式可能因实现而异。 返回的字符串可能为空，但可能不是null 。

重写：

paramString类 AbstractButton

结果

此 JButton的字符串表示 JButton

getAccessibleContext

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

获取与AccessibleContext相关的JButton 。 为JButton s时， AccessibleContext需要一个的形式AccessibleJButton 。 如有必要，将创建一个新的AccessibleJButton实例。

Specified by:

getAccessibleContext ，接口 Accessible

重写：

getAccessibleContext类 Component

结果

AccessibleJButton ，作为 AccessibleContext的 JButton