Класс Метка

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`.

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

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

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

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

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

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

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

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

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

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

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

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

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

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

ЛЕВО

public static final int LEFT

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

См. также:

ЦЕНТР

public static final int CENTER

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

См. также:

ПРАВО

public static final int RIGHT

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

См. также:

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

Метка

public Label() throws HeadlessException

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

Выбрасывает:

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

См. также:

Метка

public Label(String text) throws HeadlessException

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

Параметры:

text - строка, которую отображает метка. Значение null будет принято без вызова NullPointerException.

Выбрасывает:

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

См. также:

Метка

public Label(String text, int alignment) throws HeadlessException

Создаёт новую метку, отображающую указанную строку текста с указанным выравниванием. Возможные значения для alignment - Label.LEFT, Label.RIGHT и Label.CENTER.

Параметры:

text - строка, которую отображает метка. Значение null будет принято без вызова NullPointerException.

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

Выбрасывает:

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

См. также:

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

addNotify

public void addNotify()

Создаёт виджет-представитель для этой метки. Представитель позволяет изменять внешний вид метки без изменения её функциональности.

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

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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/Label.html