|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 | |||||||||
java.lang.Objectjava.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.AbstractButton
public abstract class AbstractButton
定义按钮和菜单项的一般行为。有关更多信息,请参阅《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.BltBufferStrategy, Component.FlipBufferStrategy |
| 从类 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()
|
|
| 方法摘要 | |
|---|---|
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 添加到复选框中。 |
protected int |
checkHorizontalKey(int key,
String exception)
验证 key 对于 horizontalAlignment 属性是否合法。 |
protected int |
checkVerticalKey(int key,
String exception)
确保 key 是有效的。 |
protected void |
configurePropertiesFromAction(Action a)
该工厂方法根据 Action 实例中的值设置 ActionEvent 源的属性。 |
protected ActionListener |
createActionListener()
|
protected PropertyChangeListener |
createActionPropertyChangeListener(Action a)
该工厂方法创建 PropertyChangeListener,用来在 Action 实例上的属性更改时更新 ActionEvent 源。 |
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()
以索引形式返回字符,它表示助记符字符,外观应该对其提供装饰。 |
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)
重写的此方法在当前 Icon 的 Image 不等于传入的 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 |
setAction(Action a)
设置 ActionEvent 源的 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 |
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 属性重置为当前外观中的一个值。 |
| 从类 java.lang.Object 继承的方法 |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
| 字段详细信息 |
|---|
public static final String MODEL_CHANGED_PROPERTY
public static final String TEXT_CHANGED_PROPERTY
public static final String MNEMONIC_CHANGED_PROPERTY
public static final String MARGIN_CHANGED_PROPERTY
public static final String VERTICAL_ALIGNMENT_CHANGED_PROPERTY
public static final String HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY
public static final String VERTICAL_TEXT_POSITION_CHANGED_PROPERTY
public static final String HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY
public static final String BORDER_PAINTED_CHANGED_PROPERTY
public static final String FOCUS_PAINTED_CHANGED_PROPERTY
public static final String ROLLOVER_ENABLED_CHANGED_PROPERTY
public static final String CONTENT_AREA_FILLED_CHANGED_PROPERTY
public static final String ICON_CHANGED_PROPERTY
public static final String PRESSED_ICON_CHANGED_PROPERTY
public static final String SELECTED_ICON_CHANGED_PROPERTY
public static final String ROLLOVER_ICON_CHANGED_PROPERTY
public static final String ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY
public static final String DISABLED_ICON_CHANGED_PROPERTY
public static final String DISABLED_SELECTED_ICON_CHANGED_PROPERTY
protected ButtonModel model
protected ChangeListener changeListener
changeListener。
protected ActionListener actionListener
ActionListener。
protected ItemListener itemListener
ItemListener。
protected transient ChangeEvent changeEvent
ChangeEvent,因为事件的惟一状态是 source 属性。所生成事件的 source 总是 "this"。
| 构造方法详细信息 |
|---|
public AbstractButton()
| 方法详细信息 |
|---|
public String getText()
setText(java.lang.String)public void setText(String text)
text - 用于设置文本的字符串getText()public boolean isSelected()
public void setSelected(boolean b)
actionEvent。调用 doClick 执行程序上的操作更改。
b - 如果选择了按钮,则该参数为 true,否则为 falsepublic void doClick()
public void doClick(int pressTime)
pressTime 毫秒的时间。
pressTime - “按下”按钮的时间,以毫秒为单位public void setMargin(Insets m)
null 会造成按钮使用默认空白。按钮的默认 Border 对象将使用该值来创建适当的空白。不过,如果在按钮上设置非默认边框,则由 Border 对象负责创建适当的空白(否则此属性将被忽略)。
m - 边框和标签之间的间隔public Insets getMargin()
Insets 对象setMargin(java.awt.Insets)public Icon getIcon()
IconsetIcon(javax.swing.Icon)public void setIcon(Icon defaultIcon)
defaultIcon - 用作默认图像的图标getIcon(),
setPressedIcon(javax.swing.Icon)public Icon getPressedIcon()
pressedIcon 属性setPressedIcon(javax.swing.Icon)public void setPressedIcon(Icon pressedIcon)
pressedIcon - 用作“按下”图像的图标getPressedIcon()public Icon getSelectedIcon()
selectedIcon 属性setSelectedIcon(javax.swing.Icon)public void setSelectedIcon(Icon selectedIcon)
selectedIcon - 用作“选择”图像的图标getSelectedIcon()public Icon getRolloverIcon()
rolloverIcon 属性setRolloverIcon(javax.swing.Icon)public void setRolloverIcon(Icon rolloverIcon)
rolloverIcon - 用作“翻转”图像的图标getRolloverIcon()public Icon getRolloverSelectedIcon()
rolloverSelectedIcon 属性setRolloverSelectedIcon(javax.swing.Icon)public void setRolloverSelectedIcon(Icon rolloverSelectedIcon)
rolloverSelectedIcon - 用作“选择翻转”图像的图标getRolloverSelectedIcon()public Icon getDisabledIcon()
一些外观上可能没有呈现禁用图标,在这种情况下,它们将忽略此图标。
public void setDisabledIcon(Icon disabledIcon)
disabledIcon - 用作禁用图像的图标getDisabledIcon()public Icon getDisabledSelectedIcon()
getDisabledIcon()。
一些外观上可能没有呈现禁用选择 Icon,在这种情况下,它们将忽略此图标。
disabledSelectedIcon 属性getDisabledIcon(),
setDisabledSelectedIcon(javax.swing.Icon),
LookAndFeel.getDisabledSelectedIcon(javax.swing.JComponent, javax.swing.Icon)public void setDisabledSelectedIcon(Icon disabledSelectedIcon)
disabledSelectedIcon - 用作禁用选择图像的图标getDisabledSelectedIcon()public int getVerticalAlignment()
verticalAlignment 属性,它是以下值之一:
public void setVerticalAlignment(int alignment)
alignment - 它是以下值之一:
public int getHorizontalAlignment()
horizontalAlignment 属性,它是以下值之一:
public void setHorizontalAlignment(int alignment)
alignment - 它是以下值之一:
public int getVerticalTextPosition()
verticalTextPosition 属性,它是以下值之一:
public void setVerticalTextPosition(int textPosition)
textPosition - 它是以下值之一:
public int getHorizontalTextPosition()
horizontalTextPosition 属性,它是以下值之一:
public void setHorizontalTextPosition(int textPosition)
textPosition - 它是以下值之一:
IllegalArgumentException - 如果 textPosition 不是上面列出的合法值之一public int getIconTextGap()
setIconTextGap(int)public void setIconTextGap(int iconTextGap)
此属性的默认值为 4 个像素。
这是一个 JavaBeans bound 属性。
getIconTextGap()
protected int checkHorizontalKey(int key,
String exception)
horizontalAlignment 属性是否合法。
key - 要检查的属性值,它是以下值之一:
exception - IllegalArgumentException 细节消息
IllegalArgumentException - 如果 key 不是上面列出的合法值之一setHorizontalTextPosition(int),