public abstract class AbstractButton extends JComponent implements ItemSelectable, SwingConstants
按钮可以配置,并在一定程度上由Action
s控制。 使用带按钮的Action
除了直接配置按钮之外,还有很多好处。 请参阅Swing Components Supporting Action
了解更多详情,您可以找到更多信息How to Use Actions ,在Java教程的部分。
有关更多信息,请参阅How to Use Buttons, Check Boxes, and Radio Buttons “Java教程 ”中的一节。
警告:此类的序列化对象与将来的Swing版本不兼容。 当前的序列化支持适用于运行相同版本的Swing的应用程序之间的短期存储或RMI。 从1.4开始,对所有JavaBeans的长期存储的支持已经添加到java.beans
包中。 请参阅XMLEncoder
。
Modifier and Type | Class and Description |
---|---|
protected class |
AbstractButton.AccessibleAbstractButton
这个类实现了可访问性支持
AbstractButton 类。
|
protected class |
AbstractButton.ButtonChangeListener
扩展
ChangeListener 可串行化。
|
JComponent.AccessibleJComponent
Container.AccessibleAWTContainer
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
Constructor and Description |
---|
AbstractButton() |
Modifier and Type | Method and Description |
---|---|
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()
想要处理
ChangeEvents 子类可以覆盖此值以返回另一个
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()
返回当前设置
Action 这个
ActionEvent 来源,或
null 如果没有
Action 设置。
|
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 传递的,
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并且按钮具有边框,则
BorderPainted 按钮的边框。
|
protected String |
paramString()
返回此
AbstractButton 的字符串表示
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 的焦点状态,必须为
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属性重置为当前外观的值。
|
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, 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, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, 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
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
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, getAccessibleContext, 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, 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, transferFocusBackward, transferFocusUpCycle
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
,因为事件的唯一状态是源属性。
生成的事件的来源总是“这”。
public void setHideActionText(boolean hideActionText)
hideActionText
属性,它决定按钮是否显示Action
文本。
只有当这是非常有用Action
已经安装上的按钮。
hideActionText
- true
如果按钮的text
属性不应该反映Action
;
默认值为false
Action
public boolean getHideActionText()
hideActionText
属性的值,该属性确定按钮是否显示Action
文本。
只有当这是非常有用Action
已经安装上的按钮。
true
如果按钮的text
属性不应该反映Action
;
默认为false
public String getText()
setText(java.lang.String)
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
对象,指定了botton边框和标签之间的边距
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()
其他。
一些看起来和感觉可能不会使残疾人选择的图标,在这种情况下,他们将忽略这一点。
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等JCheckBox
可能使用不同的默认值。
horizontalAlignment
属性,以下值之一:
SwingConstants.RIGHT
SwingConstants.LEFT
SwingConstants.CENTER
SwingConstants.LEADING
SwingConstants.TRAILING
public void setHorizontalAlignment(int alignment)
AbstractButton
的默认值为SwingConstants.CENTER
,但JCheckBox等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
中用于无效值的消息
key
参数
IllegalArgumentException
- 如果密钥不是上面列出的合法值之一
setHorizontalTextPosition(int)
,
setHorizontalAlignment(int)
protected int checkVerticalKey(int key, String exception)
key
参数是垂直属性的合法值。
有效值为:
SwingConstants.CENTER
SwingConstants.TOP
SwingConstants.BOTTOM
key
- 要检查的属性值
exception
-
IllegalArgumentException
中用于无效值的消息
key
参数
IllegalArgumentException
- 如果密钥不是上面列出的合法值之一
public void removeNotify()
KeyboardAction
。
该方法在内部被工具包调用,不应该被程序直接调用。
public void setActionCommand(String actionCommand)
actionCommand
- 此按钮的动作命令
public String getActionCommand()
public void setAction(Action a)
Action
。
新的Action
替换任何以前设置的Action
但不影响ActionListeners
独立添加与addActionListener
。
如果Action
已经是该按钮注册的ActionListener
,则不会重新注册。
设置Action
会立即更改Swing Components Supporting Action
中描述的所有属性 。 随后,按钮的属性将自动更新为Action
的属性更改。
此方法使用另外三种方法来设置和帮助跟踪Action
的属性值。 它使用configurePropertiesFromAction
方法立即更改按钮的属性。 要跟踪Action
的属性值中的更改,此方法注册PropertyChangeListener
返回的createActionPropertyChangeListener
。 默认PropertyChangeListener
调用actionPropertyChanged
方法时的属性Action
变化。
a
-
Action
为
AbstractButton
,或
null
Action
, getAction()
, configurePropertiesFromAction(javax.swing.Action)
, createActionPropertyChangeListener(javax.swing.Action)
, actionPropertyChanged(javax.swing.Action, java.lang.String)
public Action getAction()
Action
为
ActionEvent
源,或
null
如果没有设置
Action
。
Action
为
ActionEvent
源,或
null
Action
, setAction(javax.swing.Action)
protected void configurePropertiesFromAction(Action a)
Action
。
有关此设置的详细信息,请参阅Swing Components Supporting Action
。
a
-
Action
获取属性的Action,或
null
Action
, setAction(javax.swing.Action)
protected void actionPropertyChanged(Action action, String propertyName)
PropertyChangeListener
返回的createActionPropertyChangeListener
调用此方法。
子类通常不需要调用它。
支持额外的Action Action
子类应该覆盖此和configurePropertiesFromAction
。
有关此方法设置的属性的列表,请参阅Swing Components Supporting Action
中的表。
action
- 与此按钮相关
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
。
一些外观和感觉可能不支持borderPainted
属性,在这种情况下,他们忽略此。
b
- 如果true和border属性不是
null
,则绘制边框
isBorderPainted()
protected void paintBorder(Graphics g)
BorderPainted
属性为true并且按钮具有边框,则
BorderPainted
按钮的边框。
paintBorder
在类别
JComponent
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
的焦点状态,属性必须为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-by-L&F而异。
b
- 如果为true,则填写内容;
如果虚拟内容区域未填写
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
键码之一java.awt.event.KeyEvent
。 这些代码和国际键盘的更广泛的代码可以通过java.awt.event.KeyEvent.getExtendedKeyCodeForChar
获得。 助记符不区分大小写,因此具有相应键码的键事件将导致按钮被激活,无论Shift修改器是否被按下。
如果在按钮的标签字符串中找到由助记符定义的字符,则它的第一次出现将被加下划线以向用户指示助记符。
mnemonic
- 表示助记符的关键代码
KeyEvent
, setDisplayedMnemonicIndex(int)
public void setMnemonic(char mnemonic)
setMnemonic(int)
设置一个按钮的助记符。
该方法仅用于处理“a”和“z”或“A”和“Z”之间的字符值。
mnemonic
- 指定助记符值的char
setMnemonic(int)
public void setDisplayedMnemonicIndex(int index) throws IllegalArgumentException
这个值被更新为与助记符变化相关的属性(如助记符本身,文本...)。 如果您不希望默认字符被加下划线,您应该只需要调用它。 例如,如果文本为“另存为”,使用助记符为“a”,并且您希望将“A”装饰为“保存A ”,则在调用setDisplayedMnemonicIndex(5)
后,您必须调用setMnemonic(KeyEvent.VK_A)
。
index
- 索引到字符串下划线
IllegalArgumentException
- 如果
index
是> =文本的长度,或<-1
getDisplayedMnemonicIndex()
public int getDisplayedMnemonicIndex()
setDisplayedMnemonicIndex(int)
public void setMultiClickThreshhold(long threshhold)
threshhold
- 鼠标按压事件之间所需的时间量,以产生相应的动作事件
IllegalArgumentException
- 如果阈值<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 updateUI()
AbstractButton
子类型应该覆盖此更新UI。
例如, JButton
可能会执行以下操作:
setUI((ButtonUI)UIManager.getUI(
"ButtonUI", "javax.swing.plaf.basic.BasicButtonUI", this));
protected void addImpl(Component comp, Object constraints, int index)
Container.addImpl(Component, Object, int)
。
addImpl
在类别
Container
comp
- 要添加的组件
constraints
- 表示此组件的布局约束的对象
index
- 容器列表中插入组件的位置,其中
-1
表示附加到最后
IllegalArgumentException
- 如果
index
无效
IllegalArgumentException
- 如果将容器的父项添加到自身
IllegalArgumentException
- 如果向
IllegalArgumentException
添加窗口
Container.add(Component)
, Container.add(Component, int)
, Container.add(Component, java.lang.Object)
, Container.invalidate()
, LayoutManager
, LayoutManager2
public void setLayout(LayoutManager mgr)
Container.setLayout(LayoutManager)
。
setLayout
在类别
Container
mgr
- 指定的布局管理器
Container.doLayout()
,
Container.getLayout()
,
Container.invalidate()
public void addChangeListener(ChangeListener l)
ChangeListener
到按钮。
l
- 要添加的侦听器
public void removeChangeListener(ChangeListener l)
l
- 要删除的侦听器
public ChangeListener[] getChangeListeners()
ChangeListener
的数组。
ChangeListener
s或一个空数组
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()
ChangeEvents
子类可以覆盖此值以返回另一个
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)
setEnabled
在类别
JComponent
b
- true启用按钮,否则为false
Component.isEnabled()
,
Component.isLightweight()
@Deprecated public String getLabel()
getText
String
包含标签
@Deprecated public void setLabel(String label)
setText(text)
label
- 一个
String
文本的
String
public void addItemListener(ItemListener l)
ItemListener
到
checkbox
。
addItemListener
在界面
ItemSelectable
l
- 要添加的
ItemListener
ItemEvent
public void removeItemListener(ItemListener l)
ItemListener
。
removeItemListener
在界面
ItemSelectable
l
- 要删除的
ItemListener
ItemEvent
public ItemListener[] getItemListeners()
ItemListener
的数组。
ItemListener
或一个空数组,如果没有添加侦听器
public Object[] getSelectedObjects()
null
。
getSelectedObjects
在界面
ItemSelectable
null
public boolean imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
Icon
的
Image
不等于
Image
img
传递的
Image
这被覆盖返回false。
imageUpdate
在界面
ImageObserver
imageUpdate
在类别
Component
img
- 要比较的
Image
infoflags
- 用于在更新图像时重新绘制按钮的标记,并确定要绘制多少图标
x
- x坐标
y
- y坐标
w
- 宽度
h
- 高度
false
如果infoflags指示图像被完全加载;
true
否则。
ImageObserver
, Component.imageUpdate(java.awt.Image, int, int, int, int, int)
protected String paramString()
AbstractButton
的字符串表示AbstractButton
。
该方法仅用于调试目的,并且返回的字符串的内容和格式可能因实现而异。
返回的字符串可能为空,但可能不是null
。
覆盖paramString
以提供有关JFC组件特定新方面的信息。
paramString
在类别
JComponent
AbstractButton
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.