当前页面:
在线文档首页 >
JavaTM 2 Platform Standard Edition 5.0 API 规范中文版
JButton (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版
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
public class JButton
- extends AbstractButton
- implements Accessible
"push" 按钮的实现。有关使用按钮的更多信息和示例,请参阅《The Java Tutorial》中的 How to Use Buttons, Check Boxes, and Radio Buttons。
警告:此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储,或适用于在运行相同 Swing 版本的应用程序之间进行 RMI(Remote Method Invocation,远程方法调用)。从 1.4 版本开始,已在 java.beans
包中添加了支持所有 JavaBeansTM 长期存储的功能。请参见 XMLEncoder
。
从类 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.SwingConstants 继承的字段 |
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST |
从类 javax.swing.AbstractButton 继承的方法 |
addActionListener, addChangeListener, addImpl, addItemListener, checkHorizontalKey, checkVerticalKey, 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 |
从类 javax.swing.JComponent 继承的方法 |
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, 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, 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 |
JButton
public JButton()
- 创建不带有设置文本或图标的按钮。
JButton
public JButton(Icon icon)
- 创建一个带图标的按钮。
- 参数:
icon
- 显示在按钮上的 Icon 图像
JButton
public JButton(String text)
- 创建一个带文本的按钮。
- 参数:
text
- 按钮的文本
JButton
public JButton(Action a)
- 创建一个按钮,其属性从所提供的
Action
中获取。
- 参数:
a
- 用于指定新按钮的 Action
- 从以下版本开始:
- 1.3
JButton
public JButton(String text,
Icon icon)
- 创建一个带初始文本和图标的按钮。
- 参数:
text
- 按钮的文本icon
- 显示在按钮上的 Icon 图像
updateUI
public void updateUI()
- 根据当前外观的值重置 UI 属性。
- 覆盖:
- 类
AbstractButton
中的 updateUI
- 另请参见:
JComponent.updateUI()
getUIClassID
public String getUIClassID()
- 返回指定呈现此组件的 L&F 类的类名,以字符串的形式。
- 覆盖:
- 类
JComponent
中的 getUIClassID
- 返回:
- 字符串 "ButtonUI"
- 另请参见:
JComponent.getUIClassID()
,
UIDefaults.getUI(javax.swing.JComponent)
isDefaultButton
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
public void setDefaultCapable(boolean defaultCapable)
- 设置
defaultCapable
属性,该属性确定此按钮是否可以是其根窗格的默认按钮。除非由外观另行指定,否则 defaultCapable
属性的默认值为 true
。
- 参数:
defaultCapable
- 如果此按钮可以是 RootPane
上的默认按钮,则该参数为 true
;否则为 false
- 另请参见:
isDefaultCapable()
removeNotify
public void removeNotify()
- 重写
JComponent.removeNotify
来检查此按钮当前是否被设置为 RootPane
上的默认按钮,如果是,则将 RootPane
的默认按钮设置为 null
,以确保 RootPane
不继续停留在无效的按钮引用上。
- 覆盖:
- 类
JComponent
中的 removeNotify
- 另请参见:
JComponent.registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)
configurePropertiesFromAction
protected void configurePropertiesFromAction(Action a)
- 该工厂方法根据
Action
实例中的值设置 AbstractButton
的属性。所设置的属性可能随 AbstractButton
子类的不同而不同。默认情况下,设置的属性为 Text、Icon、Enabled、ToolTipText、ActionCommand
和 Mnemonic
。
- 覆盖:
- 类
AbstractButton
中的 configurePropertiesFromAction
- 参数:
a
- 从其获取属性的 Action
,或者为 null
- 从以下版本开始:
- 1.3
- 另请参见:
Action
,
AbstractButton.setAction(javax.swing.Action)
paramString
protected String paramString()
- 返回此
JButton
的字符串表示形式。此方法仅在进行调试的时候使用,对于各个实现,所返回字符串的内容和格式可能有所不同。返回的字符串可能为空,但不可能为 null
。
- 覆盖:
- 类
AbstractButton
中的 paramString
- 返回:
- 此
JButton
的字符串表示形式
getAccessibleContext
public AccessibleContext getAccessibleContext()
- 获得与此
JButton
关联的 AccessibleContext
。对于 JButton
,AccessibleContext
采用 AccessibleJMenuItem
的形式。如有必要,可创建一个新的 AccessibleJButton
实例。
- 指定者:
- 接口
Accessible
中的 getAccessibleContext
- 覆盖:
- 类
JComponent
中的 getAccessibleContext
- 返回:
- 一个
AccessibleJButton
,它将充当此 JButton
的 AccessibleContext
提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。 版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。