ImageObserver
, MenuContainer
, Serializable
, Accessible
public class Label extends Component implements Accessible
Label
object is a component for placing text in a container. A label displays a single line of read-only text. The text can be changed by the application, but a user cannot edit it directly. For example, the code . . .
setLayout(new FlowLayout(FlowLayout.CENTER, 10, 10)); add(new Label("Hi There!")); add(new Label("Another Label"));
produces the following labels:
Modifier and Type | Class | Description |
---|---|---|
protected class |
Label.AccessibleAWTLabel |
This class implements accessibility support for the Label class. |
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
Modifier and Type | Field | Description |
---|---|---|
static final int |
CENTER |
Indicates that the label should be centered. |
static final int |
LEFT |
Indicates that the label should be left justified. |
static final int |
RIGHT |
Indicates that the label should be right justified. |
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
Constructor | Description |
---|---|
Label() |
Constructs an empty label. |
Label |
Constructs a new label with the specified string of text, left justified. |
Label |
Constructs a new label that presents the specified string of text with the specified alignment. |
Modifier and Type | Method | Description |
---|---|---|
void |
addNotify() |
Creates the peer for this label. |
AccessibleContext |
getAccessibleContext() |
Gets the AccessibleContext associated with this Label. |
int |
getAlignment() |
Gets the current alignment of this label. |
String |
getText() |
Gets the text of this label. |
protected String |
paramString() |
Returns a string representing the state of this Label . |
void |
setAlignment |
Sets the alignment for this label to the specified alignment. |
void |
setText |
Sets the text for this label to the specified text. |
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, getListeners, 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, 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, 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
public static final int LEFT
public static final int CENTER
public static final int RIGHT
public Label() throws HeadlessException
""
.HeadlessException
- if GraphicsEnvironment.isHeadless() returns true.public Label(String text) throws HeadlessException
text
- the string that the label presents. A null
value will be accepted without causing a NullPointerException to be thrown.HeadlessException
- if GraphicsEnvironment.isHeadless() returns true.public Label(String text, int alignment) throws HeadlessException
alignment
are Label.LEFT
, Label.RIGHT
, and Label.CENTER
.text
- the string that the label presents. A null
value will be accepted without causing a NullPointerException to be thrown.alignment
- the alignment value.HeadlessException
- if GraphicsEnvironment.isHeadless() returns true.public void addNotify()
public int getAlignment()
Label.LEFT
, Label.RIGHT
, and Label.CENTER
.public void setAlignment(int alignment)
Label.LEFT
, Label.RIGHT
, and Label.CENTER
.alignment
- the alignment to be set.IllegalArgumentException
- if an improper value for alignment
is given.public String getText()
null
if the text has been set to null
.public void setText(String text)
text
- the text that this label displays. If text
is null
, it is treated for display purposes like an empty string ""
.protected String paramString()
Label
. This method is intended to be used only for debugging purposes, and the content and format of the returned string may vary between implementations. The returned string may be empty but may not be null
.paramString
in class Component
public AccessibleContext getAccessibleContext()
getAccessibleContext
in interface Accessible
getAccessibleContext
in class Component
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/java/awt/Label.html