- java.lang.Object
-
- java.awt.Component
-
- java.awt.Button
-
- 实现的所有接口
-
ImageObserver
,MenuContainer
,Serializable
,Accessible
public class Button extends Component implements Accessible
该类创建一个带标签的按钮。 按下按钮时,应用程序可能会导致某些操作发生。 此图像描绘了Solaris操作系统下显示的“Quit
”按钮的三个视图:第一个视图显示正常显示的按钮。 第二个视图显示具有输入焦点的按钮。 它的轮廓变暗,让用户知道它是一个活动对象。 第三个视图显示用户在按钮上单击鼠标时的按钮,从而请求执行操作。
使用鼠标单击按钮的手势与
ActionEvent
一个实例相关联,当按下鼠标并通过按钮释放时,该实例将被发送出去。 如果应用程序有兴趣知道按钮何时被按下但未被释放,则作为单独的手势,它可以专门化processMouseEvent
,或者它可以通过调用addMouseListener
将自己注册为鼠标事件的监听addMouseListener
。 这两种方法都是由Component
定义的,它是所有组件的抽象超类。当按下和释放按钮,AWT发送的一个实例
ActionEvent
到按钮,通过调用processEvent
上的按钮。 按钮的processEvent
方法接收按钮的所有事件; 它通过调用自己的processActionEvent
方法传递一个动作事件。 后一种方法将动作事件传递给已注册对此按钮生成的动作事件感兴趣的任何动作侦听器。如果应用程序想要根据按下和释放的按钮执行某些操作,它应该实现
ActionListener
并通过调用按钮的addActionListener
方法注册新的侦听器以从此按钮接收事件。 应用程序可以使用按钮的action命令作为消息传递协议。
-
-
嵌套类汇总
嵌套类 变量和类型 类 描述 protected class
Button.AccessibleAWTButton
此类实现Button
类的可访问性支持。
-
字段汇总
-
声明的属性在类 java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
-
Fields declared in interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
-
-
方法摘要
所有方法 实例方法 具体的方法 变量和类型 方法 描述 void
addActionListener(ActionListener l)
添加指定的动作侦听器以从此按钮接收动作事件。void
addNotify()
创建按钮的对等方。AccessibleContext
getAccessibleContext()
获取AccessibleContext
与此相关Button
。String
getActionCommand()
返回此按钮触发的动作事件的命令名称。ActionListener[]
getActionListeners()
返回在此按钮上注册的所有动作侦听器的数组。String
getLabel()
获取此按钮的标签。<T extends EventListener>
T[]getListeners(类<T> listenerType)
返回当前注册的所有对象的数组FooListener
在这个SButton
。protected String
paramString()
返回表示此Button
的状态的字符串。protected void
processActionEvent(ActionEvent e)
处理在此按钮上发生的操作事件,方法是将它们分派给任何已注册的ActionListener
对象。protected void
processEvent(AWTEvent e)
处理此按钮上的事件。void
removeActionListener(ActionListener l)
删除指定的操作侦听器,以便它不再从此按钮接收操作事件。void
setActionCommand(String command)
设置此按钮触发的动作事件的命令名称。void
setLabel(String label)
将按钮的标签设置为指定的字符串。-
声明方法的类 java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setMixingCutoutShape, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate
-
-
-
-
构造方法详细信息
-
Button
public Button() throws HeadlessException
构造一个带有空字符串的按钮作为其标签。- 异常
-
HeadlessException
- 如果GraphicsEnvironment.isHeadless()返回true - 另请参见:
-
GraphicsEnvironment.isHeadless()
-
Button
public Button(String label) throws HeadlessException
构造具有指定标签的按钮。- 参数
-
label
- 按钮的字符串标签,或null
(无标签) - 异常
-
HeadlessException
- 如果GraphicsEnvironment.isHeadless()返回true - 另请参见:
-
GraphicsEnvironment.isHeadless()
-
-
方法详细信息
-
addNotify
public void addNotify()
创建按钮的对等方。 按钮的对等体允许应用程序在不更改其功能的情况下更改按钮的外观。- 重写:
-
addNotify
在类Component
- 另请参见:
-
Component.getToolkit()
-
getLabel
public String getLabel()
获取此按钮的标签。- 结果
-
按钮的标签,如果按钮没有标签,
null
。 - 另请参见:
-
setLabel(java.lang.String)
-
setLabel
public void setLabel(String label)
将按钮的标签设置为指定的字符串。- 参数
-
label
- 新标签,如果按钮没有标签,null
。 - 另请参见:
-
getLabel()
-
setActionCommand
public void setActionCommand(String command)
设置此按钮触发的动作事件的命令名称。 默认情况下,此操作命令设置为与按钮的标签匹配。- 参数
-
command
- 用于设置按钮动作命令的字符串。 如果字符串是null
则将action命令设置为与按钮的标签匹配。 - 从以下版本开始:
- 1.1
- 另请参见:
-
ActionEvent
-
getActionCommand
public String getActionCommand()
返回此按钮触发的动作事件的命令名称。 如果命令名称为null
(默认值),则此方法返回按钮的标签。- 结果
- 此按钮的操作命令名称(或标签)
-
addActionListener
public void addActionListener(ActionListener l)
添加指定的动作侦听器以从此按钮接收动作事件。 当用户在此按钮上按下或释放鼠标时,会发生操作事件。 如果l为null,则不抛出任何异常并且不执行任何操作。有关AWT螺纹模型的详细信息,请参阅AWT Threading Issues 。
- 参数
-
l
- 动作侦听器 - 从以下版本开始:
- 1.1
- 另请参见:
-
removeActionListener(java.awt.event.ActionListener)
,getActionListeners()
,ActionListener
-
removeActionListener
public void removeActionListener(ActionListener l)
删除指定的操作侦听器,以便它不再从此按钮接收操作事件。 当用户在此按钮上按下或释放鼠标时,会发生操作事件。 如果l为null,则不抛出任何异常并且不执行任何操作。有关AWT线程模型的详细信息,请参阅AWT Threading Issues 。
- 参数
-
l
- 动作侦听器 - 从以下版本开始:
- 1.1
- 另请参见:
-
addActionListener(java.awt.event.ActionListener)
,getActionListeners()
,ActionListener
-
getActionListeners
public ActionListener[] getActionListeners()
返回在此按钮上注册的所有动作侦听器的数组。- 结果
-
所有这个按钮的
ActionListener
s或如果当前没有注册动作监听器的空数组 - 从以下版本开始:
- 1.4
- 另请参见:
-
addActionListener(java.awt.event.ActionListener)
,removeActionListener(java.awt.event.ActionListener)
,ActionListener
-
getListeners
public <T extends EventListener> T[] getListeners(类<T> listenerType)
返回当前在此Button
注册为FooListener
的所有对象的数组。FooListener
s使用addFooListener
方法注册。您可以使用类文字指定
listenerType
参数,例如FooListener.class
。 例如,您可以使用以下代码查询Button b
的动作侦听器:ActionListener[] als = (ActionListener[])(b.getListeners(ActionListener.class));
如果不存在此类侦听器,则此方法返回空数组。- 重写:
-
getListeners
在类Component
- 参数类型
-
T
- 侦听器的类型 - 参数
-
listenerType
- 请求的侦听器类型; 此参数应指定一个从java.util.EventListener
下降的接口 - 结果
-
此按钮上注册为
FooListener
的所有对象的数组,如果未添加此类侦听器,则为空数组 - 异常
-
ClassCastException
- 如果listenerType
未指定实现java.util.EventListener
的类或接口 - 从以下版本开始:
- 1.3
- 另请参见:
-
getActionListeners()
-
processEvent
protected void processEvent(AWTEvent e)
处理此按钮上的事件。 如果事件是ActionEvent
的实例,则此方法将调用processActionEvent
方法。 否则,它processEvent
在超类上调用processEvent
。请注意,如果事件参数为
null
则行为未指定,可能会导致异常。- 重写:
-
processEvent
在类Component
- 参数
-
e
- 活动 - 从以下版本开始:
- 1.1
- 另请参见:
-
ActionEvent
,processActionEvent(java.awt.event.ActionEvent)
-
processActionEvent
protected void processActionEvent(ActionEvent e)
处理在此按钮上发生的操作事件,方法是将它们分派给任何已注册的ActionListener
对象。除非为此按钮启用了操作事件,否则不会调用此方法。 发生以下任一情况时启用操作事件:
-
ActionListener
对象的注册号为addActionListener
。 - 通过
enableEvents
启用操作事件。
请注意,如果事件参数为
null
则行为未指定,可能会导致异常。- 参数
-
e
- 动作事件 - 从以下版本开始:
- 1.1
- 另请参见:
-
ActionListener
,addActionListener(java.awt.event.ActionListener)
,Component.enableEvents(long)
-
-
paramString
protected String paramString()
返回表示此Button
的状态的字符串。 此方法仅用于调试目的,返回字符串的内容和格式可能因实现而异。 返回的字符串可能为空,但可能不是null
。- 重写:
-
paramString
在Component
类 - 结果
- 此按钮的参数字符串
-
getAccessibleContext
@BeanProperty(expert=true, description="The AccessibleContext associated with this Button.") public AccessibleContext getAccessibleContext()
获取AccessibleContext
与此相关Button
。 对于按钮,AccessibleContext
需要一个的形式AccessibleAWTButton
。 如有必要,将创建一个新的AccessibleAWTButton
实例。- Specified by:
-
getAccessibleContext
在界面Accessible
- 重写:
-
getAccessibleContext
在Component
类 - 结果
-
AccessibleAWTButton
,作为AccessibleContext
的Button
- 从以下版本开始:
- 1.3
-
-