Class Label

java.lang.Object

vaadinx.awt.Component

vaadinx.awt.Label

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible

public class Label
extends Component
implements Accessible

Emulator for Label — AWT 1.0 static text, not JLabel, rendered by an SLabel peer:

Label total = new Label("Total", Label.RIGHT);
panel.add(total, BorderLayout.NORTH);   // fills the region; text right-aligned
total.setText("Total: 42");

The JDK class is text plus a three-value alignment and nothing else — no listeners at all. Everything a migrator touches beyond the members below (setBounds, setFont, setForeground, setVisible, addMouseListener, …) is inherited Component.

text and alignment are the JDK's fields, and the getters answer from them on any thread without reaching the peer — so getText() returns null verbatim where the peer's Vaadin-backed read would say "". Leaf peer is locked down per R_leaf_peer_lockdown: no protected (Component peer) ctor, so every instance — including a user-code subclass — peers over an SLabel.

The alignment constants are java.awt.Label's own (0/1/2) and collide numerically with SwingConstants' LEFT/CENTER/RIGHT (2/0/4) — a value borrowed from the Swing set means something else here, or throws.

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final int	CENTER	Center the label's text.
static final int	LEFT	Left-align the label's text — the AWT default.
static final int	RIGHT	Right-align the label's text.

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
Label()	JDK chains this to this("", LEFT) — the text is empty, not null.
Label(String text)
Label(String text, int alignment)

Method Summary

Modifier and Type	Method	Description
void	addNotify()
AccessibleContext	getAccessibleContext()
int	getAlignment()
String	getText()
protected String	paramString()
void	setAlignment(int alignment)
void	setText(String text)

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, processEvent, 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

Field Details

LEFT

public static final int LEFT

Left-align the label's text — the AWT default.

See Also:

• Constant Field Values

CENTER

public static final int CENTER

Center the label's text.

See Also:

• Constant Field Values

RIGHT

public static final int RIGHT

Right-align the label's text.

See Also:

• Constant Field Values

Constructor Details

Label

public Label()
      throws HeadlessException

JDK chains this to this("", LEFT) — the text is empty, not null.

Throws:

HeadlessException

Label

public Label(String text)
      throws HeadlessException

Throws:

HeadlessException

Label

public Label(String text,
 int alignment)
      throws HeadlessException

Parameters:

text - null is legal and reads back from getText() verbatim

alignment - LEFT / CENTER / RIGHT

Throws:

IllegalArgumentException - on any other alignment, as in AWT

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

Method Details

addNotify

public void addNotify()

Overrides:

addNotify in class Component

getText

public String getText()

Returns:

the text as stored — null when constructed or set with null

setText

public void setText(String text)

Parameters:

text - null is stored and read back verbatim; the peer renders blank

getAlignment

public int getAlignment()

setAlignment

public void setAlignment(int alignment)

Throws:

IllegalArgumentException - on a value outside LEFT / CENTER / RIGHT, as in AWT (R_match_swing_errors)

paramString

protected String paramString()

Overrides:

paramString in class Component

getAccessibleContext

public AccessibleContext getAccessibleContext()

Specified by:

getAccessibleContext in interface Accessible

Overrides:

getAccessibleContext in class Component