Class Button

java.lang.Object

vaadinx.awt.Component

vaadinx.awt.Button

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible

public class Button
extends Component
implements Accessible

Emulator for Button — a thin delegating shell over its SButton peer. Not to be confused with JButton: this is the AWT 1.0 push button, whose entire API is twelve methods with no ButtonModel, no Action, no icon, no mnemonic and no selected state. Everything a migrator touches beyond the members below — setBounds, setFont, setBackground, setEnabled, addMouseListener, requestFocus — is inherited Component.

Responsibility split with the peer:

• Surrogate — the rendered Vaadin Button, the ClickNotifier → ActionEvent fan-out, and the actionCommand-falls-back-to-label rule.
• Emulator (here) — the AWT-shape API migrated code compiles against: ActionListener with source == this Button, and a label field shadow so getLabel() returns null verbatim where the surrogate's Vaadin-backed getText() would say "" (R_swing_is_truth over the accepted R_vaadin_first loss).

Leaf peer is locked down per R_leaf_peer_lockdown: java.awt.Button has no public subclass in java.awt, so there is no protected (Component peer) ctor and every instance peers over an SButton.

See Also:

• Serialized Form

Field Summary

Fields inherited from class Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, FILL_CHROME, FILL_DEFAULT, LEFT_ALIGNMENT, listenerList, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor	Description
Button()	JDK chains the no-arg ctor to this("") — the label is empty, not null.
Button(String label)

Method Summary

Modifier and Type	Method	Description
void	addActionListener(ActionListener l)
void	addNotify()
AccessibleContext	getAccessibleContext()
String	getActionCommand()
ActionListener[]	getActionListeners()
String	getLabel()
protected String	paramString()
protected void	processActionEvent(ActionEvent e)	The single funnel every action reaches the listeners through — both the peer click bridge and a user-code processEvent call.
protected void	processEvent(AWTEvent e)
void	removeActionListener(ActionListener l)
void	setActionCommand(String command)
void	setLabel(String label)

Methods inherited from class Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyBackgroundToPeer, applyComponentOrientation, applyVisibleToPeer, areFocusTraversalKeysSet, awtListeners, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, defaultFillCssClass, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, fireComponentEvent, fireHierarchyEvent, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBaseline, 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, getListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, 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, isThemeDefault, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, peerIs, 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, 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, suppressMouseBridge, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate, withPeer, withPeerOnLiveUI

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

Button

public Button()
       throws HeadlessException

JDK chains the no-arg ctor to this("") — the label is empty, not null.

Throws:

HeadlessException

Button

public Button(String label)
       throws HeadlessException

Parameters:

label - null is legal and reads back from getLabel() verbatim

Throws:

HeadlessException - never in practice — the clause is kept for signature fidelity, matching Frame

Method Details

addNotify

public void addNotify()

Overrides:

addNotify in class Component

getLabel

public String getLabel()

setLabel

public void setLabel(String label)

getActionCommand

public String getActionCommand()

setActionCommand

public void setActionCommand(String command)

addActionListener

public void addActionListener(ActionListener l)

removeActionListener

public void removeActionListener(ActionListener l)

getActionListeners

public ActionListener[] getActionListeners()

processEvent

protected void processEvent(AWTEvent e)

Overrides:

processEvent in class Component

processActionEvent

protected void processActionEvent(ActionEvent e)

The single funnel every action reaches the listeners through — both the peer click bridge and a user-code processEvent call. AWT subclasses override this (calling super) to intercept actions wholesale, so it must stay the only dispatch path.

paramString

protected String paramString()

Overrides:

paramString in class Component

getAccessibleContext

public AccessibleContext getAccessibleContext()

Specified by:

getAccessibleContext in interface Accessible

Overrides:

getAccessibleContext in class Component