|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.awt.Component java.awt.Container javax.swing.JComponent javax.swing.AbstractButton
public abstract class AbstractButton
定义按钮和菜单项的一般行为。
按钮可以进行配置,以及通过 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 |
从类 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 参数是否为 horizontalAlignment 和 horizontalTextPosition 属性的合法值。 |
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) 重写的此方法在当前 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 |
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 属性重置为当前外观中的一个值。 |
从类 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
,因为事件的唯一状态是源属性。所生成的事件源总是 "this"。
构造方法详细信息 |
---|
public AbstractButton()
方法详细信息 |
---|
public void setHideActionText(boolean hideActionText)
hideActionText
属性,该属性确定按钮是否显示
Action
的文本。只有在按钮上已安装了
Action
时,此方法才有用。
hideActionText
- 如果按钮的
text
属性不应该反映
Action
的文本,则该参数为
true
;默认情况下为
false
Action
的 Swing 组件
public boolean getHideActionText()
hideActionText
属性的值,该属性确定按钮是否显示
Action
的文本。只有在按钮上已安装了
Action
时,此方法才有用。
text
属性不应该反映
Action
的文本,则返回
true
;默认情况下返回
false
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,否则为 false
public 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()
Icon
setIcon(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()
一些外观上可能没有呈现禁用图标,在这种情况下,它们将忽略此图标。
disabledIcon
属性
getPressedIcon()
,
setDisabledIcon(javax.swing.Icon)
,
LookAndFeel.getDisabledIcon(javax.swing.JComponent, javax.swing.Icon)
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
属性,它是以下值之一:
SwingConstants.CENTER
(默认值) SwingConstants.TOP
SwingConstants.BOTTOM
public void setVerticalAlignment(int alignment)
alignment
- 它是以下值之一:
SwingConstants.CENTER
(默认值) SwingConstants.TOP
SwingConstants.BOTTOM
IllegalArgumentException
- 如果对齐方式不是上面列出的合法值之一
public int getHorizontalAlignment()
AbstractButton
的默认对齐方式为
SwingConstants.CENTER
,但子类(如
JCheckBox
)可以使用不同的默认对齐方式。
horizontalAlignment
属性,它是以下值之一:
SwingConstants.RIGHT
SwingConstants.LEFT
SwingConstants.CENTER
SwingConstants.LEADING
SwingConstants.TRAILING
public void setHorizontalAlignment(int alignment)
AbstractButton
的默认对齐方式为
SwingConstants.CENTER
,但子类(如
JCheckBox
)可以使用不同的默认对齐方式。
alignment
- 对齐方式的值,它是以下值之一:
SwingConstants.RIGHT
SwingConstants.LEFT
SwingConstants.CENTER
SwingConstants.LEADING
SwingConstants.TRAILING
IllegalArgumentException
- 如果对齐方式不是有效值之一
public int getVerticalTextPosition()
verticalTextPosition
属性,它是以下值之一:
SwingConstants.CENTER
(默认值) SwingConstants.TOP
SwingConstants.BOTTOM
public void setVerticalTextPosition(int textPosition)
textPosition
- 它是以下值之一:
SwingConstants.CENTER
(默认值) SwingConstants.TOP
SwingConstants.BOTTOM
public int getHorizontalTextPosition()
horizontalTextPosition
属性,它是以下值之一:
SwingConstants.RIGHT
SwingConstants.LEFT
SwingConstants.CENTER
SwingConstants.LEADING
SwingConstants.TRAILING
(默认值) public void setHorizontalTextPosition(int textPosition)
textPosition
- 它是以下值之一:
SwingConstants.RIGHT
SwingConstants.LEFT
SwingConstants.CENTER
SwingConstants.LEADING
SwingConstants.TRAILING
(默认值) IllegalArgumentException
- 如果
textPosition
不是上面列出的合法值之一
public int getIconTextGap()
setIconTextGap(int)
public void setIconTextGap(int iconTextGap)
此属性的默认值为 4 个像素。
这是一个 JavaBeans 绑定属性。
getIconTextGap()
protected int checkHorizontalKey(int key, String exception)
key
参数是否为
horizontalAlignment
和
horizontalTextPosition
属性的合法值。有效值有:
SwingConstants.RIGHT
SwingConstants.LEFT
SwingConstants.CENTER
SwingConstants.LEADING
SwingConstants.TRAILING
key
- 要检查的属性值
exception
-
IllegalArgumentException
中要使用的消息,无效值时抛出
IllegalArgumentException
- 如果 key 不是上面列出的合法值之一
setHorizontalTextPosition(int)
,
setHorizontalAlignment(int)
protected int checkVerticalKey(int key, String exception)
key
参数是否为垂直属性的合法值。有效值有:
SwingConstants.CENTER
SwingConstants.TOP
SwingConstants.BOTTOM
key
- 要检查的属性值
exception
-
IllegalArgumentException
中要使用的消息,无效值时抛出
IllegalArgumentException
- 如果 key 不是上面列出的合法值之一
public void removeNotify()
KeyboardAction
。
JComponent
中的
removeNotify
JComponent.registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)
public void setActionCommand(String actionCommand)
actionCommand
- 此按钮的动作命令
public String getActionCommand()
public void setAction(Action a)
Action
。新
Action
将替换所有以前设置的
Action
,但不影响单独使用
addActionListener
添加的
ActionListener
。如果
Action
已经是按钮的已注册
ActionListener
,则它不需要重新注册。
设置 Action
导致支持 Action
的 Swing 组件中描述的所有属性立即更改。随后,按钮的属性根据 Action
的属性的更改进行自动更新。
此方法可以使用三个其他方法设置并帮助跟踪 Action
的属性值。它使用 configurePropertiesFromAction
方法可立即更改按钮的属性。要跟踪 Action
的属性值中的更改,此方法应注册 createActionPropertyChangeListener
返回的 PropertyChangeListener
。Action
中的属性更改时,默认 PropertyChangeListener
调用 actionPropertyChanged
方法。
a
-
AbstractButton
的
Action
,或为
null
Action
,
getAction()
,
configurePropertiesFromAction(javax.swing.Action)
,
createActionPropertyChangeListener(javax.swing.Action)
,
actionPropertyChanged(javax.swing.Action, java.lang.String)
public Action getAction()
ActionEvent
源设置的
Action
,如果没有设置任何
Action
,则返回
null
。
ActionEvent
源的
Action
,或
null
Action
,
setAction(javax.swing.Action)
protected void configurePropertiesFromAction(Action a)
Action
中的属性。有关关于设置了哪些属性的更多信息,请参阅
支持 Action
的 Swing 组件。
a
- 从中获取属性的
Action
,或为
null
Action
,
setAction(javax.swing.Action)
protected void actionPropertyChanged(Action action, String propertyName)
createActionPropertyChangeListener
返回的
PropertyChangeListener
中调用此方法。子类通常不需要调用此方法。支持其他
Action
属性的子类应该重写此方法以及
configurePropertiesFromAction
。
有关此方法设置的属性的列表,请参阅支持 Action
的 Swing 组件处的表。
action
- 与此按钮关联的
Action
propertyName
- 已更改属性的名称
Action
,
configurePropertiesFromAction(javax.swing.Action)
protected PropertyChangeListener createActionPropertyChangeListener(Action a)
PropertyChangeListener
,它负责侦听指定
Action
的更改以及更新适当的属性。
警告:如果为此类创建子类,则不要创建匿名内部类。否则,按钮的生命周期将依赖于 Action
的生命周期。
a
- 按钮的操作
Action
,
setAction(javax.swing.Action)
public boolean isBorderPainted()
borderPainted
属性。
borderPainted
属性的值
setBorderPainted(boolean)
public void setBorderPainted(boolean b)
borderPainted
属性。如果该属性为
true
并且按钮有边框,则绘制该边框。
borderPainted
属性的默认值为
true
。
b
- 如果为 true 并且边框属性不为
null
,则绘制该边框
isBorderPainted()
protected void paintBorder(Graphics g)
BorderPainted
属性为 true 并且按钮有边框,则绘制该按钮边框。
JComponent
中的
paintBorder
g
- 在其中进行绘制的
Graphics
环境
JComponent.paint(java.awt.Graphics)
,
JComponent.setBorder(javax.swing.border.Border)
public boolean isFocusPainted()
paintFocus
属性。
paintFocus
属性
setFocusPainted(boolean)
public void setFocusPainted(boolean b)
paintFocus
属性,对于要绘制的焦点状态,该属性必须为
true
。
paintFocus
属性的默认值为
true
。一些外观没有绘制焦点状态;它们将忽略此属性。
b
- 如果为
true
,则应绘制焦点状态
isFocusPainted()
public boolean isContentAreaFilled()
contentAreaFilled
属性。
contentAreaFilled
属性
setContentAreaFilled(boolean)
public void setContentAreaFilled(boolean b)
contentAreaFilled
属性。如果该属性为
true
,则按钮将绘制内容区域。如果希望有一个透明的按钮,比如只是一个图标的按钮,那么应该将此属性设置为
false
。不要调用
setOpaque(false)
。
contentAreaFilled
属性的默认值为
true
。
此方法可能造成组件的不透明属性发生更改。
调用此方法的具体行为在各个组件和各个 L&F 之间是各不相同的。
b
- 如果为 true,则应该填充内容;如果为 false,则不填充内容区域
isContentAreaFilled()
,
JComponent.setOpaque(boolean)
public boolean isRolloverEnabled()
rolloverEnabled
属性。
rolloverEnabled
属性的值
setRolloverEnabled(boolean)
public void setRolloverEnabled(boolean b)
rolloverEnabled
属性,若需要翻转效果,该属性必须为
true
。
rolloverEnabled
属性的默认值为
false
。一些外观也许不实现翻转效果;它们将忽略此属性。
b
- 如果为
true
,则应绘制翻转效果
isRolloverEnabled()
public int getMnemonic()
public void setMnemonic(int mnemonic)
一个助记符必须对应键盘上的一个键,并且应该使用 java.awt.event.KeyEvent
中定义的 VK_XXX
键代码之一指定。助记符是不区分大小写的,所以具有相应键代码的键事件将造成按钮被激活,不管是否按下 Shift 修饰符。
如果在按钮的标签字符串中发现由助记符定义的字符,则第一个出现的助记符将是带下划线的,以向用户指示该助记符。
mnemonic
- 表示助记符的键代码
KeyEvent
,
setDisplayedMnemonicIndex(int)
public void setMnemonic(char mnemonic)
setMnemonic(int)
来设置按钮的助记符。此方法仅设计用于处理 'a' 到 'z' 或 'A' 到 'Z'之间的字符值。
mnemonic
- 指定助记符值的字符
setMnemonic(int)
public void setDisplayedMnemonicIndex(int index) throws IllegalArgumentException
与助记符相关的属性发生更改时(比如助记符本身、文本……),此索引值也被更改。如果不希望默认字符带下划线,那么只能不断地调用此方法。例如,如果文本 'Save As' 带有一个助记符 'a',您想装饰 'A'(比如装饰成 'Save As'),那么您必须在调用 setMnemonic(KeyEvent.VK_A)
之后调用 setDisplayedMnemonicIndex(5)
。
index
- String 中的索引,指示要加下划线的字符
IllegalArgumentException
- 如果
index
>= 文本的长度,或者 < -1,则抛出该异常
getDisplayedMnemonicIndex()
public int getDisplayedMnemonicIndex()
setDisplayedMnemonicIndex(int)
public void setMultiClickThreshhold(long threshhold)
threshhold
- 按下鼠标到生成相应动作事件所需的时间量
IllegalArgumentException
- 如果 threshhold < 0
getMultiClickThreshhold()
public long getMultiClickThreshhold()
setMultiClickThreshhold(long)
public ButtonModel getModel()
model
属性
setModel(javax.swing.ButtonModel)
public void setModel(ButtonModel newModel)
newModel
- 新的
ButtonModel
getModel()
public ButtonUI getUI()
setUI(javax.swing.plaf.ButtonUI)
public void setUI(ButtonUI ui)
ui
-
ButtonUI
L&F 对象
getUI()
public void updateUI()
AbstractButton
的子类型应该重写此方法来更新 UI。例如,
JButton
可以执行以下操作:
setUI((ButtonUI)UIManager.getUI( "ButtonUI", "javax.swing.plaf.basic.BasicButtonUI", this));
JComponent
中的
updateUI
JComponent.setUI(javax.swing.plaf.ComponentUI)
,
UIManager.getLookAndFeel()
,
UIManager.getUI(javax.swing.JComponent)
protected void addImpl(Component comp, Object constraints, int index)
Container.addImpl(Component, Object, int)
。
Container
中的
addImpl
comp
- 要添加的组件
constraints
- 表示此组件的布局约束的对象
index
- 容器列表中插入组件的位置,
-1
表示添加到列表的末尾
IllegalArgumentException
- 如果
index
无效
IllegalArgumentException
- 如果将容器的父容器添加到该容器自身中
IllegalArgumentException
- 如果将一个窗口添加到容器中
Container.add(Component)
,
Container.add(Component, int)
,
Container.add(Component, java.lang.Object)
,
LayoutManager
,
LayoutManager2
public void setLayout(LayoutManager mgr)
Container.setLayout(LayoutManager)
。
Container
中的
setLayout
mgr
- 指定的布局管理器
Container.doLayout()
,
Container.getLayout()
public void addChangeListener(ChangeListener l)
ChangeListener
。
l
- 要添加的侦听器
public void removeChangeListener(ChangeListener l)
l
- 要移除的侦听器
public ChangeListener[] getChangeListeners()
ChangeListener
组成的数组。
ChangeListener
,如果没有添加侦听器,则返回一个空数组
protected void fireStateChanged()
EventListenerList
public void addActionListener(ActionListener l)
ActionListener
添加到按钮中。
l
- 要添加的
ActionListener
public void removeActionListener(ActionListener l)
ActionListener
。如果侦听器是按钮当前设置的
Action
,则将
Action
设置为
null
。
l
- 要移除的侦听器
public ActionListener[] getActionListeners()
ActionListener
组成的数组。
ActionListener
,如果没有添加侦听器,则返回一个空数组
protected ChangeListener createChangeListener()
ChangeEvent
的子类可以重写此方法,以返回另一个
ChangeListener
实现。
ChangeListener
protected void fireActionPerformed(ActionEvent event)
event
参数以延迟方式创建事件实例。
event
-
ActionEvent
对象
EventListenerList
protected void fireItemStateChanged(ItemEvent event)
event
参数以延迟方式创建事件实例。
event
-
ItemEvent
对象
EventListenerList
protected ActionListener createActionListener()
protected ItemListener createItemListener()
public void setEnabled(boolean b)
JComponent
中的
setEnabled
b
- true 表示启用按钮,否则为 false
Component.isEnabled()
,
Component.isLightweight()
@Deprecated public String getLabel()
getText
取代
String
@Deprecated public void setLabel(String label)
setText(text)
取代
label
- 包含文本的
String
public void addItemListener(ItemListener l)
ItemListener
添加到
checkbox
中。
ItemSelectable
中的
addItemListener
l
- 要添加的
ItemListener
ItemEvent
public void removeItemListener(ItemListener l)
ItemListener
。
ItemSelectable
中的
removeItemListener
l
- 要移除的
ItemListener
ItemEvent
public ItemListener[] getItemListeners()
ItemListener
组成的数组。
ItemListener
,如果没有添加侦听器,则返回一个空数组
public Object[] getSelectedObjects()
null
。
ItemSelectable
中的
getSelectedObjects
null
protected void init(String text, Icon icon)
public boolean imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
Icon
的
Image
不等于传入的
Image
img
时返回 false。
ImageObserver
中的
imageUpdate
Component
中的
imageUpdate
img
- 要比较的
Image
infoflags
- 更新图像时用于重绘按钮的标志,它确定将绘制多大的区域
x
- x 坐标
y
- y 坐标
w
- 宽度
h
- 高度
false
;否则返回
true
。
ImageObserver
,
Component.imageUpdate(java.awt.Image, int, int, int, int, int)
protected String paramString()
AbstractButton
的字符串表示形式。此方法仅在进行调试的时候使用,对于各个实现,所返回字符串的内容和格式可能有所不同。返回的字符串可能为空,但不可能为
null
。
重写 paramString
来提供有关 JFC 组件的一些特定新方面的信息。
JComponent
中的
paramString
AbstractButton
的字符串表示形式
|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。