站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

AbstractButton (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版


JavaTM Platform
Standard Ed. 6

javax.swing
类 AbstractButton

java.lang.Object
  继承者 java.awt.Component
      继承者 java.awt.Container
          继承者 javax.swing.JComponent
              继承者 javax.swing.AbstractButton
所有已实现的接口:
ImageObserver, ItemSelectable, MenuContainer, Serializable, SwingConstants
直接已知子类:
JButton, JMenuItem, JToggleButton

public abstract class AbstractButton
extends JComponent
implements ItemSelectable, SwingConstants

定义按钮和菜单项的一般行为。

按钮可以进行配置,以及通过 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 版本的应用程序之间进行 RMI(Remote Method Invocation,远程方法调用)。从 1.4 版本开始,已在 java.beans 包中添加了支持所有 JavaBeansTM 长期存储的功能。请参见 XMLEncoder


嵌套类摘要
protected  class AbstractButton.AccessibleAbstractButton
          此类实现对 AbstractButton 类的可访问性支持。
protected  class AbstractButton.ButtonChangeListener
          将 ChangeListener 扩展为可序列化的。
 
从类 javax.swing.JComponent 继承的嵌套类/接口
JComponent.AccessibleJComponent
 
从类 java.awt.Container 继承的嵌套类/接口
Container.AccessibleAWTContainer
 
从类 java.awt.Component 继承的嵌套类/接口
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
字段摘要
protected  ActionListener actionListener
          按钮模型的 ActionListener
static String BORDER_PAINTED_CHANGED_PROPERTY
          标识是否绘制边框的更改。
protected  ChangeEvent changeEvent
          每个按钮实例都只需要一个 ChangeEvent,因为事件的唯一状态是源属性。
protected  ChangeListener changeListener
          按钮模型的 changeListener
static String CONTENT_AREA_FILLED_CHANGED_PROPERTY
          标识对按钮绘制的内容区域的更改。
static String DISABLED_ICON_CHANGED_PROPERTY
          标识禁用按钮时使用的图标的更改。
static String DISABLED_SELECTED_ICON_CHANGED_PROPERTY
          标识禁用并选定按钮时使用的图标的更改。
static String FOCUS_PAINTED_CHANGED_PROPERTY
          标识是否在边框拥有焦点时高亮显示。
static String HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY
          标识按钮的水平对齐方式的更改。
static String HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY
          标识按钮的水平文本位置的更改。
static String ICON_CHANGED_PROPERTY
          标识对表示该按钮的图标的更改。
protected  ItemListener itemListener
          按钮模型的 ItemListener
static String MARGIN_CHANGED_PROPERTY
          标识按钮的边界空白的更改。
static String MNEMONIC_CHANGED_PROPERTY
          标识按钮的助记符中的更改。
protected  ButtonModel model
          确定按钮状态的数据模型。
static String MODEL_CHANGED_PROPERTY
          标识按钮模型中的更改。
static String PRESSED_ICON_CHANGED_PROPERTY
          标识对按下按钮时使用的图标的更改。
static String ROLLOVER_ENABLED_CHANGED_PROPERTY
          标识从启用翻转到禁用翻转或者从禁用翻转到启用翻转的更改。
static String ROLLOVER_ICON_CHANGED_PROPERTY
          标识对光标移动到按钮上时使用的图标的更改。
static String ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY
          标识对光标移动到按钮上并选定该按钮时使用的图标的更改。
static String SELECTED_ICON_CHANGED_PROPERTY
          标识对选定按钮时使用的图标的更改。
static String TEXT_CHANGED_PROPERTY
          标识按钮的文本中的更改。
static String VERTICAL_ALIGNMENT_CHANGED_PROPERTY
          标识按钮的垂直对齐方式的更改。
static String 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
 
构造方法摘要
AbstractButton()
           
 
方法摘要
protected  void actionPropertyChanged(Action action, String propertyName)
          更新按钮的状态以响应相关的操作中的属性更改。
 void addActionListener(ActionListener l)
          将一个 ActionListener 添加到按钮中。
 void addChangeListener(ChangeListener l)
          向按钮添加一个 ChangeListener
protected  void addImpl(Component comp, Object constraints, int index)
          将指定组件添加到此容器的指定索引所在的位置上,有关此方法的完整描述,请参阅 Container.addImpl(Component, Object, int)
 void addItemListener(ItemListener l)
          将一个 ItemListener 添加到 checkbox 中。
protected  int checkHorizontalKey(int key, String exception)
          验证 key 参数是否为 horizontalAlignmenthorizontalTextPosition 属性的合法值。
protected  int checkVerticalKey(int key, String exception)
          验证 key 参数是否为垂直属性的合法值。
protected  void configurePropertiesFromAction(Action a)
          在此按钮上设置属性以匹配指定 Action 中的属性。
protected  ActionListener createActionListener()
           
protected  PropertyChangeListener createActionPropertyChangeListener(Action a)
          创建并返回 PropertyChangeListener,它负责侦听指定 Action 的更改以及更新适当的属性。
protected  ChangeListener createChangeListener()
          想以不同的方式处理 ChangeEvent 的子类可以重写此方法,以返回另一个 ChangeListener 实现。
protected  ItemListener createItemListener()
           
 void doClick()
          以编程方式执行“单击”。
 void doClick(int pressTime)
          以编程方式执行“单击”。
protected  void fireActionPerformed(ActionEvent event)
          通知所有需要此事件类型的通知的已注册侦听器。
protected  void fireItemStateChanged(ItemEvent event)
          通知所有需要此事件类型的通知的已注册侦听器。
protected  void fireStateChanged()
          通知所有需要此事件类型的通知的已注册侦听器。
 Action getAction()
          返回当前为此 ActionEvent 源设置的 Action,如果没有设置任何 Action,则返回 null
 String getActionCommand()
          返回此按钮的动作命令。
 ActionListener[] getActionListeners()
          返回使用 addActionListener() 添加到此 AbstractButton 的所有 ActionListener 组成的数组。
 ChangeListener[] getChangeListeners()
          返回使用 addChangeListener() 添加到此 AbstractButton 中的所有 ChangeListener 组成的数组。
 Icon getDisabledIcon()
          返回禁用按钮时按钮使用的图标。
 Icon getDisabledSelectedIcon()
          返回禁用并选择按钮时按钮使用的图标。
 int getDisplayedMnemonicIndex()
          以索引形式返回字符,它表示助记符字符,外观应该对其提供装饰。
 boolean getHideActionText()
          返回 hideActionText 属性的值,该属性确定按钮是否显示 Action 的文本。
 int getHorizontalAlignment()
          返回图标和文本的水平对齐方式。
 int getHorizontalTextPosition()
          返回文本相对于图标的水平位置。
 Icon getIcon()
          返回默认图标。
 int getIconTextGap()
          返回此按钮中显示的文本与图标之间的间隔量。
 ItemListener[] getItemListeners()
          返回使用 addItemListener() 添加到此 AbstractButton 中的所有 ItemListener 组成的数组。
 String getLabel()
          已过时。 - 由 getText 取代
 Insets getMargin()
          返回按钮边框和标签之间的空白。
 int getMnemonic()
          返回当前模型中的键盘助记符。
 ButtonModel getModel()
          返回此按钮表示的模型。
 long getMultiClickThreshhold()
          获取对按钮按下鼠标到生成相应动作事件所需的时间量(以毫秒为单位)。
 Icon getPressedIcon()
          返回按钮的按下图标。
 Icon getRolloverIcon()
          返回按钮的翻转图标。
 Icon getRolloverSelectedIcon()
          返回按钮的翻转选定图标。
 Icon getSelectedIcon()
          返回按钮的选择图标。
 Object[] getSelectedObjects()
          返回包含标签的数组(长度为 1),如果没有选择按钮,则返回 null
 String getText()
          返回按钮的文本。
 ButtonUI getUI()
          返回呈现此组件的 L&F 对象。
 int getVerticalAlignment()
          返回文本和图标的垂直对齐方式。
 int getVerticalTextPosition()
          返回文本相对于图标的垂直位置。
 boolean imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
          重写的此方法在当前 IconImage 不等于传入的 Image img 时返回 false。
protected  void init(String text, Icon icon)
           
 boolean isBorderPainted()
          获取 borderPainted 属性。
 boolean isContentAreaFilled()
          获取 contentAreaFilled 属性。
 boolean isFocusPainted()
          获取 paintFocus 属性。
 boolean isRolloverEnabled()
          获取 rolloverEnabled 属性。
 boolean isSelected()
          返回按钮的状态。
protected  void paintBorder(Graphics g)
          如果 BorderPainted 属性为 true 并且按钮有边框,则绘制该按钮边框。
protected  String paramString()
          返回此 AbstractButton 的字符串表示形式。
 void removeActionListener(ActionListener l)
          从按钮中移除一个 ActionListener
 void removeChangeListener(ChangeListener l)
          从按钮中移除一个 ChangeListener。
 void removeItemListener(ItemListener l)
          从按钮中移除一个 ItemListener
 void removeNotify()
          通知此组件它不再有父组件。
 void setAction(Action a)
          设置 Action
 void setActionCommand(String actionCommand)
          设置此按钮的动作命令。
 void setBorderPainted(boolean b)
          设置 borderPainted 属性。
 void setContentAreaFilled(boolean b)
          设置 contentAreaFilled 属性。
 void setDisabledIcon(Icon disabledIcon)
          设置按钮的禁用图标。
 void setDisabledSelectedIcon(Icon disabledSelectedIcon)
          设置按钮的禁用选择图标。
 void setDisplayedMnemonicIndex(int index)
          提供关于应该装饰文本中哪一个字符来表示助记符的外观提示。
 void setEnabled(boolean b)
          启用(或禁用)按钮。
 void setFocusPainted(boolean b)
          设置 paintFocus 属性,对于要绘制的焦点状态,该属性必须为 true
 void setHideActionText(boolean hideActionText)
          设置 hideActionText 属性,该属性确定按钮是否显示 Action 的文本。
 void setHorizontalAlignment(int alignment)
          设置图标和文本的水平对齐方式。
 void setHorizontalTextPosition(int textPosition)
          设置文本相对于图标的水平位置。
 void setIcon(Icon defaultIcon)
          设置按钮的默认图标。
 void setIconTextGap(int iconTextGap)
          如果图标和文本的属性都已设置,则此属性定义图标和文本之间的间隔。
 void setLabel(String label)
          已过时。 - 由 setText(text) 取代
 void setLayout(LayoutManager mgr)
          为此容器设置布局管理器,有关此方法的完整描述,请参阅 Container.setLayout(LayoutManager)
 void setMargin(Insets m)
          设置按钮边框和标签之间的空白。
 void setMnemonic(char mnemonic)
          此方法现在已废弃,请使用 setMnemonic(int) 来设置按钮的助记符。
 void setMnemonic(int mnemonic)
          设置当前模型上的键盘助记符。
 void setModel(ButtonModel newModel)
          设置此按钮表示的模型。
 void setMultiClickThreshhold(long threshhold)
          设置对按钮按下鼠标到生成相应动作事件所需的时间量(以毫秒为单位)。
 void setPressedIcon(Icon pressedIcon)
          设置按钮的按下图标。
 void setRolloverEnabled(boolean b)
          设置 rolloverEnabled 属性,若需要翻转效果,该属性必须为 true
 void setRolloverIcon(Icon rolloverIcon)
          设置按钮的翻转图标。
 void setRolloverSelectedIcon(Icon rolloverSelectedIcon)
          设置按钮的翻转选择图标。
 void setSelected(boolean b)
          设置按钮的状态。
 void setSelectedIcon(Icon selectedIcon)
          设置按钮的选择图标。
 void setText(String text)
          设置按钮的文本。
 void setUI(ButtonUI ui)
          设置呈现此组件的 L&F 对象。
 void setVerticalAlignment(int alignment)
          设置图标和文本的垂直对齐方式。
 void setVerticalTextPosition(int textPosition)
          设置文本相对于图标的垂直位置。
 void updateUI()
          将 UI 属性重置为当前外观中的一个值。
 
从类 javax.swing.JComponent 继承的方法
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getAccessibleContext, 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, getUIClassID, 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
 

字段详细信息

MODEL_CHANGED_PROPERTY

public static final String MODEL_CHANGED_PROPERTY
标识按钮模型中的更改。

另请参见:
常量字段值

TEXT_CHANGED_PROPERTY

public static final String TEXT_CHANGED_PROPERTY
标识按钮的文本中的更改。

另请参见:
常量字段值

MNEMONIC_CHANGED_PROPERTY

public static final String MNEMONIC_CHANGED_PROPERTY
标识按钮的助记符中的更改。

另请参见:
常量字段值

MARGIN_CHANGED_PROPERTY

public static final String MARGIN_CHANGED_PROPERTY
标识按钮的边界空白的更改。

另请参见:
常量字段值

VERTICAL_ALIGNMENT_CHANGED_PROPERTY

public static final String VERTICAL_ALIGNMENT_CHANGED_PROPERTY
标识按钮的垂直对齐方式的更改。

另请参见:
常量字段值

HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY

public static final String HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY
标识按钮的水平对齐方式的更改。

另请参见:
常量字段值

VERTICAL_TEXT_POSITION_CHANGED_PROPERTY

public static final String VERTICAL_TEXT_POSITION_CHANGED_PROPERTY
标识按钮的垂直文本位置的更改。

另请参见:
常量字段值

HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY

public static final String HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY
标识按钮的水平文本位置的更改。

另请参见:
常量字段值

BORDER_PAINTED_CHANGED_PROPERTY

public static final String BORDER_PAINTED_CHANGED_PROPERTY
标识是否绘制边框的更改。

另请参见:
常量字段值

FOCUS_PAINTED_CHANGED_PROPERTY

public static final String FOCUS_PAINTED_CHANGED_PROPERTY
标识是否在边框拥有焦点时高亮显示。

另请参见:
常量字段值

ROLLOVER_ENABLED_CHANGED_PROPERTY

public static final String ROLLOVER_ENABLED_CHANGED_PROPERTY
标识从启用翻转到禁用翻转或者从禁用翻转到启用翻转的更改。

另请参见:
常量字段值

CONTENT_AREA_FILLED_CHANGED_PROPERTY

public static final String CONTENT_AREA_FILLED_CHANGED_PROPERTY
标识对按钮绘制的内容区域的更改。

另请参见:
常量字段值

ICON_CHANGED_PROPERTY

public static final String ICON_CHANGED_PROPERTY
标识对表示该按钮的图标的更改。

另请参见:
常量字段值

PRESSED_ICON_CHANGED_PROPERTY

public static final String PRESSED_ICON_CHANGED_PROPERTY
标识对按下按钮时使用的图标的更改。

另请参见:
常量字段值

SELECTED_ICON_CHANGED_PROPERTY

public static final String SELECTED_ICON_CHANGED_PROPERTY
标识对选定按钮时使用的图标的更改。

另请参见:
常量字段值

ROLLOVER_ICON_CHANGED_PROPERTY

public static final String ROLLOVER_ICON_CHANGED_PROPERTY
标识对光标移动到按钮上时使用的图标的更改。

另请参见:
常量字段值

ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY

public static final String ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY
标识对光标移动到按钮上并选定该按钮时使用的图标的更改。

另请参见:
常量字段值

DISABLED_ICON_CHANGED_PROPERTY

public static final String DISABLED_ICON_CHANGED_PROPERTY
标识禁用按钮时使用的图标的更改。

另请参见:
常量字段值

DISABLED_SELECTED_ICON_CHANGED_PROPERTY

public static final String DISABLED_SELECTED_ICON_CHANGED_PROPERTY
标识禁用并选定按钮时使用的图标的更改。

另请参见:
常量字段值

model

protected ButtonModel model
确定按钮状态的数据模型。


changeListener

protected ChangeListener changeListener
按钮模型的 changeListener


actionListener

protected ActionListener actionListener
按钮模型的 ActionListener


itemListener

protected ItemListener itemListener
按钮模型的 ItemListener


changeEvent

protected transient ChangeEvent changeEvent
每个按钮实例都只需要一个 ChangeEvent,因为事件的唯一状态是源属性。所生成的事件源总是 "this"。

构造方法详细信息

AbstractButton

public AbstractButton()
方法详细信息

setHideActionText

public void setHideActionText(boolean hideActionText)
设置 hideActionText 属性,该属性确定按钮是否显示 Action 的文本。只有在按钮上已安装了 Action 时,此方法才有用。

参数:
hideActionText - 如果按钮的 text 属性不应该反映 Action 的文本,则该参数为 true;默认情况下为 false
从以下版本开始:
1.6
另请参见:
支持 Action 的 Swing 组件

getHideActionText

public boolean getHideActionText()
返回 hideActionText 属性的值,该属性确定按钮是否显示 Action 的文本。只有在按钮上已安装了 Action 时,此方法才有用。

返回:
如果按钮的 text 属性不应该反映 Action 的文本,则返回 true;默认情况下返回 false
从以下版本开始:
1.6

getText

public String getText()
返回按钮的文本。

返回:
按钮的文本
另请参见:
setText(java.lang.String)

setText

public void setText(String text)
设置按钮的文本。

参数:
text - 用于设置文本的字符串
另请参见:
getText()

isSelected

public boolean isSelected()
返回按钮的状态。如果选定了切换按钮,则返回 true,否则返回 false。

返回:
如果选定了切换按钮,则返回 true,否则返回 false

setSelected

public void setSelected(boolean b)
设置按钮的状态。注意,此方法不会触发 actionEvent。调用 doClick 以执行程序上的动作更改。

参数:
b - 如果选择了按钮,则该参数为 true,否则为 false

doClick

public void doClick()
以编程方式执行“单击”。此方法的效果等同于用户按下并随后释放按钮。


doClick

public void doClick(int pressTime)
以编程方式执行“单击”。此方法的效果等同于用户按下并随后释放按钮。按钮在虚拟“按下”状态下停留 pressTime 毫秒的时间。

参数:
pressTime - “按下”按钮的时间,以毫秒为单位

setMargin

public void setMargin(Insets m)
设置按钮边框和标签之间的空白。将该空白设置为 null 会造成按钮使用默认空白。按钮的默认 Border 对象将使用该值来创建适当的空白。不过,如果在按钮上设置非默认边框,则由 Border 对象负责创建适当的空白(否则此属性将被忽略)。

参数:
m - 边框和标签之间的间隔

getMargin

public Insets getMargin()
返回按钮边框和标签之间的空白。

返回:
一个指定按钮边框和标签之间的空白的 Insets 对象
另请参见:
setMargin(java.awt.Insets)

getIcon

public Icon getIcon()
返回默认图标。

返回:
默认 Icon
另请参见:
setIcon(javax.swing.Icon)

setIcon

public void setIcon(Icon defaultIcon)
设置按钮的默认图标。如果没有显式地设置按下的图标,则此图标还被用作“按下”和“禁用”图标。

参数:
defaultIcon - 用作默认图像的图标
另请参见:
getIcon(), setPressedIcon(javax.swing.Icon)

getPressedIcon

public Icon getPressedIcon()
返回按钮的按下图标。

返回:
pressedIcon 属性
另请参见:
setPressedIcon(javax.swing.Icon)

setPressedIcon

public void setPressedIcon(Icon pressedIcon)
设置按钮的按下图标。

参数:
pressedIcon - 用作“按下”图像的图标
另请参见:
getPressedIcon()

getSelectedIcon

public Icon getSelectedIcon()
返回按钮的选择图标。

返回:
selectedIcon 属性
另请参见:
setSelectedIcon(javax.swing.Icon)

setSelectedIcon

public void setSelectedIcon(Icon selectedIcon)
设置按钮的选择图标。

参数:
selectedIcon - 用作“选择”图像的图标
另请参见:
getSelectedIcon()

getRolloverIcon

public Icon getRolloverIcon()
返回按钮的翻转图标。

返回:
rolloverIcon 属性
另请参见:
setRolloverIcon(javax.swing.Icon)

setRolloverIcon

public void setRolloverIcon(Icon rolloverIcon)
设置按钮的翻转图标。

参数:
rolloverIcon - 用作“翻转”图像的图标
另请参见:
getRolloverIcon()

getRolloverSelectedIcon

public Icon getRolloverSelectedIcon()
返回按钮的翻转选定图标。

返回:
rolloverSelectedIcon 属性
另请参见:
setRolloverSelectedIcon(javax.swing.Icon)

setRolloverSelectedIcon

public void setRolloverSelectedIcon(Icon rolloverSelectedIcon)
设置按钮的翻转选择图标。

参数:
rolloverSelectedIcon - 用作“选择翻转”图像的图标
另请参见:
getRolloverSelectedIcon()

getDisabledIcon

public Icon getDisabledIcon()
返回禁用按钮时按钮使用的图标。如果没有设置禁用图标,则此方法将调用转发给外观,以构造适当的禁用 Icon。

一些外观上可能没有呈现禁用图标,在这种情况下,它们将忽略此图标。

返回:
disabledIcon 属性
另请参见:
getPressedIcon(), setDisabledIcon(javax.swing.Icon), LookAndFeel.getDisabledIcon(javax.swing.JComponent, javax.swing.Icon)

setDisabledIcon

public void setDisabledIcon(Icon disabledIcon)
设置按钮的禁用图标。

参数:
disabledIcon - 用作禁用图像的图标
另请参见:
getDisabledIcon()

getDisabledSelectedIcon

public Icon getDisabledSelectedIcon()
返回禁用并选择按钮时按钮使用的图标。如果没有设置禁用选择图标,则将调用转发给 LookAndFeel,以从选择图标中(如果已设置)构造适当的禁用图标;否则将调用转发给 getDisabledIcon()

一些外观上可能没有呈现禁用选择 Icon,在这种情况下,它们将忽略此图标。

返回:
disabledSelectedIcon 属性
另请参见:
getDisabledIcon(), setDisabledSelectedIcon(javax.swing.Icon), LookAndFeel.getDisabledSelectedIcon(javax.swing.JComponent, javax.swing.Icon)

setDisabledSelectedIcon

public void setDisabledSelectedIcon(Icon disabledSelectedIcon)
设置按钮的禁用选择图标。

参数:
disabledSelectedIcon - 用作禁用选择图像的图标
另请参见:
getDisabledSelectedIcon()

getVerticalAlignment

public int getVerticalAlignment()
返回文本和图标的垂直对齐方式。

返回:
verticalAlignment 属性,它是以下值之一:
  • SwingConstants.CENTER(默认值)
  • SwingConstants.TOP
  • SwingConstants.BOTTOM

setVerticalAlignment

public void setVerticalAlignment(int alignment)
设置图标和文本的垂直对齐方式。

参数:
alignment - 它是以下值之一:
  • SwingConstants.CENTER(默认值)
  • SwingConstants.TOP
  • SwingConstants.BOTTOM
抛出:
IllegalArgumentException - 如果对齐方式不是上面列出的合法值之一

getHorizontalAlignment

public int getHorizontalAlignment()
返回图标和文本的水平对齐方式。AbstractButton 的默认对齐方式为 SwingConstants.CENTER,但子类(如 JCheckBox)可以使用不同的默认对齐方式。

返回:
horizontalAlignment 属性,它是以下值之一:
  • SwingConstants.RIGHT
  • SwingConstants.LEFT
  • SwingConstants.CENTER
  • SwingConstants.LEADING
  • SwingConstants.TRAILING

setHorizontalAlignment

public void setHorizontalAlignment(int alignment)
设置图标和文本的水平对齐方