Класс 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 int CENTER

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

static int LEFT

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

static 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()

Создаёт виджет (peer) для этой метки.

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

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

LEFT

public static final int LEFT

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

См. также:
Значения константных полей

CENTER

public static final int CENTER

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

См. также:
Значения константных полей
public static final int RIGHT

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

См. также:
Значения константных полей

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

Label

public Label()
      throws HeadlessException

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

Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
См. также:
GraphicsEnvironment.isHeadless()

Label

public Label(String text)
      throws HeadlessException

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

Параметры:
text - строка, которую отображает метка. Значение null будет принято без выброса NullPointerException.
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
См. также:
GraphicsEnvironment.isHeadless()

Label

public Label(String text,
             int alignment)
      throws HeadlessException

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

Параметры:
text - строка, которую отображает метка. Значение null будет принято без выброса NullPointerException.
alignment - значение выравнивания.
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
См. также:
GraphicsEnvironment.isHeadless()

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

addNotify

public void addNotify()

Создаёт виджет (peer) для этой метки. Виджет (peer) позволяет нам изменять внешний вид метки без изменения её функциональности.

Переопределяет:
addNotify в классе Component
См. также:
Component.isDisplayable(), Component.removeNotify(), Component.invalidate()

getAlignment

public int getAlignment()

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

Возвращает:
выравнивание этой метки
См. также:
setAlignment(int)

setAlignment

public void setAlignment(int alignment)

Устанавливает выравнивание для этой метки на указанное выравнивание. Возможные значения — Label.LEFT, Label.RIGHT, и Label.CENTER.

Параметры:
alignment - выравнивание для установки.
Исключения:
IllegalArgumentException - если предоставлено неверное значение для alignment.
См. также:
getAlignment()

getText

public String getText()

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

Возвращает:
текст этой метки или null, если текст был установлен как null
См. также:
setText(java.lang.String)

setText

public void setText(String text)

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

Параметры:
text - текст, который отображается в этой метке. Если text — null, он отображается как пустая строка ""
См. также:
getText()

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, 2020, 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/11/docs/api/java.desktop/java/awt/Label.html

Spec-Zone .ru
спецификации, руководства, описания, API