Класс Label

java.lang.Object

java.awt.Component

java.awt.Label

Все реализуемые интерфейсы:: ImageObserver, MenuContainer, Serializable, Accessible

public class Label extends Component implements Accessible

Объект Label — это компонент для размещения текста в контейнере. Метка отображает одну строку текста, доступного только для чтения. Приложение может изменить текст, но пользователь не может редактировать его напрямую.

Например, следующий код . . .

setLayout(new FlowLayout(FlowLayout.CENTER, 10, 10));
add(new Label("Hi There!"));
add(new Label("Another Label"));

создает следующие метки:

Two labels: 'Hi There!' and
'Another label'

Начиная с:

1.0

См. также:

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`protected class`	`Label.AccessibleAWTLabel`	Этот класс реализует поддержку специальных возможностей для класса `Label`.

Вложенные классы и интерфейсы, объявленные в классе Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final int`	`CENTER`	Указывает, что метка должна быть выровнена по центру.
`static final int`	`LEFT`	Указывает, что метка должна быть выровнена по левому краю.
`static final int`	`RIGHT`	Указывает, что метка должна быть выровнена по правому краю.

Поля, объявленные в классе Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, объявленные в интерфейсе ImageObserver

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

Краткое описание конструкторов

Конструктор	Описание
`Label()`	Создает пустую метку.
`Label(String text)`	Создает новую метку с указанной строкой текста, выровненную по левому краю.
`Label(String text, int alignment)`	Создает новую метку с указанной строкой текста и заданным выравниванием.

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`addNotify()`	Создает peer-объект для этой метки.
`AccessibleContext`	`getAccessibleContext()`	Возвращает AccessibleContext, связанный с этой меткой.
`int`	`getAlignment()`	Возвращает текущее выравнивание этой метки.
`String`	`getText()`	Возвращает текст этой метки.
`protected String`	`paramString()`	Возвращает строку, представляющую состояние этого объекта `Label`.
`void`	`setAlignment(int alignment)`	Задает для этой метки указанное выравнивание.
`void`	`setText(String text)`	Задает для этой метки указанный текст.

Методы, объявленные в классе 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, 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

Методы, объявленные в классе Object

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

Подробное описание полей

LEFT

public static final int LEFT

Указывает, что метка должна быть выровнена по левому краю.

См. также:

CENTER

public static final int CENTER

Указывает, что метка должна быть выровнена по центру.

См. также:

RIGHT

public static final int RIGHT

Указывает, что метка должна быть выровнена по правому краю.

См. также:

Подробное описание конструкторов

Label

public Label() throws HeadlessException

Создает пустую метку. Текст метки — пустая строка "".

Исключения:

HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true.

См. также:

Label

public Label(String text) throws HeadlessException

Создает новую метку с указанной строкой текста, выровненную по левому краю.

Параметры:

text — строка, отображаемая меткой. Значение null допускается; при этом исключение NullPointerException не выбрасывается.

Исключения:

HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true.

См. также:

Label

public Label(String text, int alignment) throws HeadlessException

Создает новую метку с указанной строкой текста и заданным выравниванием. Допустимые значения для alignment: Label.LEFT, Label.RIGHT и Label.CENTER.

Параметры:

alignment — значение выравнивания.

Исключения:

HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true.

См. также:

Подробное описание методов

addNotify

public void addNotify()

Создает peer-объект для этой метки. Peer-объект позволяет изменять внешний вид метки, не меняя ее функциональность.

Переопределяет:

addNotify в классе Component

См. также:

getAlignment

public int getAlignment()

Возвращает текущее выравнивание этой метки. Допустимые значения: Label.LEFT, Label.RIGHT и Label.CENTER.

Возвращает:

выравнивание этой метки

См. также:

setAlignment

public void setAlignment(int alignment)

Задает для этой метки указанное выравнивание. Допустимые значения: Label.LEFT, Label.RIGHT и Label.CENTER.

Параметры:

alignment — задаваемое выравнивание.

Исключения:

IllegalArgumentException — если для alignment задано недопустимое значение.

См. также:

getText

public String getText()

Возвращает текст этой метки.

Возвращает:

текст этой метки или null, если тексту присвоено значение null.

См. также:

setText

public void setText(String text)

Задает для этой метки указанный текст.

Параметры:

text — текст, отображаемый этой меткой. Если text имеет значение null, при отображении он рассматривается как пустая строка "".

См. также:

paramString

protected String paramString()

Возвращает строку, представляющую состояние этого объекта Label. Этот метод предназначен только для отладки; содержимое и формат возвращаемой строки могут различаться в разных реализациях. Возвращаемая строка может быть пустой, но не может быть null.

Переопределяет:: paramString в классе Component
Возвращает:: строку параметров этой метки

getAccessibleContext

public AccessibleContext getAccessibleContext()

Возвращает AccessibleContext, связанный с этой меткой. Для меток AccessibleContext имеет вид AccessibleAWTLabel. При необходимости создается новый экземпляр AccessibleAWTLabel.

Указано в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе Component
Возвращает:: AccessibleAWTLabel, служащий AccessibleContext этой метки
Начиная с:: 1.3

© 1993, 2025, 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/25/docs/api/java.desktop/java/awt/Label.html