Spec-Zone.ru › OpenJDK 27

Класс 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
Модификатор и тип Класс Описание
protected class  Component.AccessibleAWTComponent
Внутренний класс Component, обеспечивающий поддержку специальных возможностей по умолчанию.
static enum  Component.BaselineResizeBehavior
Перечисление распространенных способов изменения базовой линии компонента при изменении его размера.
protected class  Component.BltBufferStrategy
Внутренний класс для вывода внеэкранных поверхностей на компонент.
protected class  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
Модификатор и тип Поле Описание
protected AccessibleContext accessibleContext
AccessibleContext, связанный с этим Component.
static final float BOTTOM_ALIGNMENT
Константа для удобства использования getAlignmentY.
static final float CENTER_ALIGNMENT
Константа для удобства использования getAlignmentY и getAlignmentX.
static final float LEFT_ALIGNMENT
Константа для удобства использования getAlignmentX.
static final float RIGHT_ALIGNMENT
Константа для удобства использования getAlignmentX.
static final float TOP_ALIGNMENT
Константа для удобства использования getAlignmentY().

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

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
Модификатор и тип Поле Описание
static final int ABORT
Этот флаг в аргументе infoflags метода imageUpdate указывает, что изображение, за которым выполнялось асинхронное наблюдение, было прервано до завершения создания.
static final int ALLBITS
Этот флаг в аргументе infoflags метода imageUpdate указывает, что статическое изображение, которое ранее отображалось, теперь полностью загружено и может быть снова отображено в окончательном виде.
static final int ERROR
Этот флаг в аргументе infoflags метода imageUpdate указывает, что при асинхронном отслеживании изображения произошла ошибка.
static final int FRAMEBITS
Этот флаг в аргументе infoflags метода imageUpdate указывает, что теперь доступен для повторного отображения еще один полный кадр ранее отображенного многостраничного изображения.
static final int HEIGHT
Этот флаг в аргументе infoflags метода imageUpdate указывает, что высота исходного изображения теперь доступна и может быть получена из аргумента height метода обратного вызова imageUpdate.
static final int PROPERTIES
Этот флаг в аргументе infoflags метода imageUpdate указывает, что свойства изображения теперь доступны.
static final int SOMEBITS
Этот флаг в аргументе infoflags метода imageUpdate указывает, что стали доступны дополнительные пиксели, необходимые для отображения масштабированной версии изображения.
static final int WIDTH
Этот флаг в аргументе infoflags метода imageUpdate указывает, что ширина исходного изображения теперь доступна и может быть получена из аргумента width метода обратного вызова imageUpdate.

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

Конструктор Описание
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
Модификатор и тип Метод Описание
boolean action(Event evt, Object what)
Устарело.
Начиная с JDK версии 1.1, следует зарегистрировать этот компонент как ActionListener компонента, генерирующего события действий.
void add(PopupMenu popup)
Добавляет указанное всплывающее меню к компоненту.
void addComponentListener(ComponentListener l)
Добавляет указанный слушатель компонента для получения событий компонента от этого компонента.
void addFocusListener(FocusListener l)
Добавляет указанный слушатель фокуса для получения событий фокуса от этого компонента при получении им фокуса ввода.
void addHierarchyBoundsListener(HierarchyBoundsListener l)
Добавляет указанный слушатель границ иерархии для получения событий границ иерархии от этого компонента при изменении иерархии, к которой принадлежит этот контейнер.
void addHierarchyListener(HierarchyListener l)
Добавляет указанный слушатель иерархии для получения событий изменения иерархии от этого компонента при изменении иерархии, к которой принадлежит этот контейнер.
void addInputMethodListener(InputMethodListener l)
Добавляет указанный слушатель метода ввода для получения событий метода ввода от этого компонента.
void addKeyListener(KeyListener l)
Добавляет указанный слушатель клавиатуры для получения событий клавиатуры от этого компонента.
void addMouseListener(MouseListener l)
Добавляет указанный слушатель мыши для получения событий мыши от этого компонента.
void addMouseMotionListener(MouseMotionListener l)
Добавляет указанный слушатель движения мыши для получения событий движения мыши от этого компонента.
void addMouseWheelListener(MouseWheelListener l)
Добавляет указанный слушатель колеса мыши для получения событий колеса мыши от этого компонента.
void addPropertyChangeListener(PropertyChangeListener listener)
Добавляет PropertyChangeListener в список слушателей.
void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)
Добавляет PropertyChangeListener в список слушателей для указанного свойства.
void applyComponentOrientation(ComponentOrientation orientation)
Устанавливает свойство ComponentOrientation этого компонента и всех содержащихся в нем компонентов.
boolean areFocusTraversalKeysSet(int id)
Возвращает, был ли явно задан для этого Component набор клавиш перехода фокуса для указанной операции перехода фокуса.
Rectangle bounds()
Устарело.
Начиная с JDK версии 1.1 заменено на getBounds().
int checkImage(Image image, int width, int height, ImageObserver observer)
Возвращает состояние создания экранного представления указанного изображения.
int checkImage(Image image, ImageObserver observer)
Возвращает состояние создания экранного представления указанного изображения.
protected AWTEvent coalesceEvents(AWTEvent existingEvent, AWTEvent newEvent)
При возможности объединяет публикуемое событие с уже существующим событием.
boolean contains(int x, int y)
Проверяет, «содержит» ли этот компонент указанную точку, координаты x и y которой заданы относительно системы координат этого компонента.
boolean contains(Point p)
Проверяет, «содержит» ли этот компонент указанную точку, координаты x и y которой заданы относительно системы координат этого компонента.
Image createImage(int width, int height)
Создает рисуемое изображение вне экрана для двойной буферизации.
Image createImage(ImageProducer producer)
Создает изображение из указанного производителя изображений.
VolatileImage createVolatileImage(int width, int height)
Создает изменяемое рисуемое изображение вне экрана для двойной буферизации.
VolatileImage createVolatileImage(int width, int height, ImageCapabilities caps)
Создает изменяемое рисуемое изображение вне экрана с указанными возможностями.
void deliverEvent(Event e)
Устарело.
Начиная с JDK версии 1.1 заменено на dispatchEvent(AWTEvent e).
void disable()
Устарело.
Начиная с JDK версии 1.1 заменено на setEnabled(boolean).
protected final void disableEvents(long eventsToDisable)
Отключает доставку этому компоненту событий, определенных параметром маски событий.
final void dispatchEvent(AWTEvent e)
Передает событие этому компоненту или одному из его подкомпонентов.
void doLayout()
Просит менеджер компоновки выполнить компоновку этого компонента.
void enable()
Устарело.
Начиная с JDK версии 1.1 заменено на setEnabled(boolean).
void enable(boolean b)
Устарело.
Начиная с JDK версии 1.1 заменено на setEnabled(boolean).
protected final void enableEvents(long eventsToEnable)
Включает доставку этому компоненту событий, определенных параметром маски событий.
void enableInputMethods(boolean enable)
Включает или отключает поддержку методов ввода для этого компонента.
protected void firePropertyChange(String propertyName, boolean oldValue, boolean newValue)
Поддержка оповещения об изменениях связанных логических свойств.
void firePropertyChange(String propertyName, byte oldValue, byte newValue)
Оповещает об изменении связанного свойства.
void firePropertyChange(String propertyName, char oldValue, char newValue)
Оповещает об изменении связанного свойства.
void firePropertyChange(String propertyName, double oldValue, double newValue)
Оповещает об изменении связанного свойства.
void firePropertyChange(String propertyName, float oldValue, float newValue)
Оповещает об изменении связанного свойства.
protected void firePropertyChange(String propertyName, int oldValue, int newValue)
Поддержка оповещения об изменениях связанных целочисленных свойств.
void firePropertyChange(String propertyName, long oldValue, long newValue)
Оповещает об изменении связанного свойства.
void firePropertyChange(String propertyName, short oldValue, short newValue)
Оповещает об изменении связанного свойства.
protected void firePropertyChange(String propertyName, Object oldValue, Object newValue)
Поддержка оповещения об изменениях связанных свойств Object.
float getAlignmentX()
Возвращает выравнивание по оси x.
float getAlignmentY()
Возвращает выравнивание по оси y.
Color getBackground()
Возвращает цвет фона этого компонента.
int getBaseline(int width, int height)
Возвращает базовую линию.
Component.BaselineResizeBehavior getBaselineResizeBehavior()
Возвращает значение перечисления, указывающее, как меняется базовая линия компонента при изменении его размера.
Rectangle getBounds()
Возвращает границы этого компонента в виде объекта Rectangle.
Rectangle getBounds(Rectangle rv)
Сохраняет границы этого компонента в «возвращаемое значение» rv и возвращает rv.
ColorModel getColorModel()
Возвращает экземпляр ColorModel, используемый для отображения компонента на устройстве вывода.
Component getComponentAt(int x, int y)
Определяет, содержит ли этот компонент или один из его непосредственных подкомпонентов точку с координатами (x, y), и, если содержит, возвращает содержащий ее компонент.
Component getComponentAt(Point p)
Возвращает компонент или подкомпонент, содержащий указанную точку.
ComponentListener[] getComponentListeners()
Возвращает массив всех слушателей компонента, зарегистрированных для этого компонента.
ComponentOrientation getComponentOrientation()
Получает зависящую от языка ориентацию, которая должна использоваться для упорядочивания элементов или текста в этом компоненте.
Cursor getCursor()
Возвращает курсор, установленный для компонента.
DropTarget getDropTarget()
Получает DropTarget, связанный с этим Component.
Container getFocusCycleRootAncestor()
Возвращает Container, являющийся корнем цикла перехода фокуса для этого Component.
FocusListener[] getFocusListeners()
Возвращает массив всех слушателей фокуса, зарегистрированных для этого компонента.
Set<AWTKeyStroke> getFocusTraversalKeys(int id)
Возвращает набор клавиш перехода фокуса для указанной операции перехода для этого Component.
boolean getFocusTraversalKeysEnabled()
Возвращает, включены ли клавиши перехода фокуса для этого Component.
Font getFont()
Возвращает шрифт этого компонента.
FontMetrics getFontMetrics(Font font)
Возвращает метрики указанного шрифта.
Color getForeground()
Возвращает цвет переднего плана этого компонента.
Graphics getGraphics()
Создает графический контекст для этого компонента.
GraphicsConfiguration getGraphicsConfiguration()
Получает GraphicsConfiguration, связанный с этим Component.
int getHeight()
Возвращает текущую высоту этого компонента.
HierarchyBoundsListener[] getHierarchyBoundsListeners()
Возвращает массив всех слушателей границ иерархии, зарегистрированных для этого компонента.
HierarchyListener[] getHierarchyListeners()
Возвращает массив всех слушателей иерархии, зарегистрированных для этого компонента.
boolean getIgnoreRepaint()
Возвращает, следует ли игнорировать сообщения о рисовании, полученные от операционной системы.
InputContext getInputContext()
Получает контекст ввода, используемый этим компонентом для обработки взаимодействия с методами ввода при вводе текста в компонент.
InputMethodListener[] getInputMethodListeners()
Возвращает массив всех слушателей методов ввода, зарегистрированных для этого компонента.
InputMethodRequests getInputMethodRequests()
Получает обработчик запросов метода ввода, который поддерживает запросы методов ввода для этого компонента.
KeyListener[] getKeyListeners()
Возвращает массив всех слушателей клавиатуры, зарегистрированных для этого компонента.
<T extends EventListener>
T[]
getListeners(Class<T> listenerType)
Возвращает массив всех объектов, зарегистрированных в данный момент как FooListener для этого Component.
Locale getLocale()
Возвращает локаль этого компонента.
Point getLocation()
Возвращает местоположение этого компонента в виде точки, задающей его верхний левый угол.
Point getLocation(Point rv)
Сохраняет координаты начала x,y этого компонента в «возвращаемом значении» rv и возвращает rv.
Point getLocationOnScreen()
Возвращает местоположение этого компонента в виде точки, задающей его верхний левый угол в системе координат экрана.
Dimension getMaximumSize()
Возвращает максимальный размер этого компонента.
Dimension getMinimumSize()
Возвращает минимальный размер этого компонента.
MouseListener[] getMouseListeners()
Возвращает массив всех обработчиков событий мыши, зарегистрированных для этого компонента.
MouseMotionListener[] getMouseMotionListeners()
Возвращает массив всех обработчиков перемещения мыши, зарегистрированных для этого компонента.
Point getMousePosition()
Возвращает положение указателя мыши в системе координат Component, если Component находится непосредственно под указателем мыши; в противном случае возвращает null.
MouseWheelListener[] getMouseWheelListeners()
Возвращает массив всех обработчиков колеса мыши, зарегистрированных для этого компонента.
String getName()
Возвращает имя компонента.
Container getParent()
Возвращает родительский компонент.
Dimension getPreferredSize()
Возвращает предпочтительный размер этого компонента.
PropertyChangeListener[] getPropertyChangeListeners()
Возвращает массив всех обработчиков изменения свойств, зарегистрированных для этого компонента.
PropertyChangeListener[] getPropertyChangeListeners(String propertyName)
Возвращает массив всех обработчиков, связанных с указанным свойством.
Dimension getSize()
Возвращает размер этого компонента в виде объекта Dimension.
Dimension getSize(Dimension rv)
Сохраняет ширину и высоту этого компонента в «возвращаемом значении» rv и возвращает rv.
Toolkit getToolkit()
Возвращает инструментарий этого компонента.
final Object getTreeLock()
Возвращает объект блокировки этого компонента (объект, которому принадлежит монитор синхронизации потоков) для операций с деревом компонентов AWT и компоновкой.
int getWidth()
Возвращает текущую ширину этого компонента.
int getX()
Возвращает текущую координату x начала координат компонента.
int getY()
Возвращает текущую координату y начала координат компонента.
boolean gotFocus(Event evt, Object what)
Устарело.
Начиная с JDK версии 1.1 заменено на processFocusEvent(FocusEvent).
boolean handleEvent(Event evt)
Устарело.
Начиная с JDK версии 1.1 заменено на processEvent(AWTEvent).
boolean hasFocus()
Возвращает true, если этот Component является владельцем фокуса.
void hide()
Устарело.
Начиная с JDK версии 1.1 заменено на setVisible(boolean).
boolean imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
Перерисовывает компонент при изменении изображения.
boolean inside(int x, int y)
Устарело.
Начиная с JDK версии 1.1 заменено на contains(int, int).
void invalidate()
Инвалидирует этот компонент и его предков.
boolean isBackgroundSet()
Возвращает, был ли явно задан цвет фона для этого компонента.
boolean isCursorSet()
Возвращает, был ли явно задан курсор для этого компонента.
boolean isDisplayable()
Определяет, отображаем ли этот компонент.
boolean isDoubleBuffered()
Возвращает true, если этот компонент рисуется во внеэкранное изображение («буфер»), которое позднее копируется на экран.
boolean isEnabled()
Определяет, включен ли этот компонент.
boolean isFocusable()
Возвращает, может ли этот компонент получать фокус.
boolean isFocusCycleRoot(Container container)
Возвращает, является ли указанный контейнер корнем цикла фокусировки для цикла обхода фокуса этого компонента.
boolean isFocusOwner()
Возвращает true, если этот Component является владельцем фокуса.
boolean isFocusTraversable()
Устарело.
Начиная с версии 1.4 заменено на isFocusable().
boolean isFontSet()
Возвращает, был ли явно задан шрифт для этого компонента.
boolean isForegroundSet()
Возвращает, был ли явно задан цвет переднего плана для этого компонента.
boolean isLightweight()
Легковесный компонент не имеет собственного узла нативного инструментария.
boolean isMaximumSizeSet()
Возвращает true, если максимальный размер задан не значением null; в противном случае возвращает false.
boolean isMinimumSizeSet()
Возвращает, был ли вызван setMinimumSize с ненулевым значением.
boolean isOpaque()
Возвращает true, если компонент полностью непрозрачен; по умолчанию возвращает false.
boolean isPreferredSizeSet()
Возвращает true, если предпочтительный размер задан не значением null; в противном случае возвращает false.
boolean isShowing()
Определяет, отображается ли этот компонент на экране.
boolean isValid()
Определяет, является ли этот компонент действительным.
boolean isVisible()
Определяет, должен ли этот компонент быть видимым, когда видим его родительский компонент.
boolean keyDown(Event evt, int key)
Устарело.
Начиная с JDK версии 1.1 заменено на processKeyEvent(KeyEvent).
boolean keyUp(Event evt, int key)
Устарело.
Начиная с JDK версии 1.1 заменено на processKeyEvent(KeyEvent).
void layout()
Устарело.
Начиная с JDK версии 1.1 заменено на doLayout().
void list()
Выводит описание этого компонента в стандартный системный поток вывода System.out.
void list(PrintStream out)
Выводит описание этого компонента в указанный поток вывода.
void list(PrintStream out, int indent)
Выводит список, начиная с указанного уровня отступа, в указанный поток печати.
void list(PrintWriter out)
Выводит описание в указанный объект PrintWriter.
void list(PrintWriter out, int indent)
Выводит список, начиная с указанного уровня отступа, в указанный объект PrintWriter.
Component locate(int x, int y)
Устарело.
Начиная с JDK версии 1.1 заменено на getComponentAt(int, int).
Point location()
Устарело.
Начиная с JDK версии 1.1 заменено на getLocation().
boolean lostFocus(Event evt, Object what)
Устарело.
Начиная с JDK версии 1.1 заменено на processFocusEvent(FocusEvent).
Dimension minimumSize()
Устарело.
Начиная с JDK версии 1.1 заменено на getMinimumSize().
boolean mouseDown(Event evt, int x, int y)
Устарело.
Начиная с JDK версии 1.1 заменено на processMouseEvent(MouseEvent).
boolean mouseDrag(Event evt, int x, int y)
Устарело.
Начиная с JDK версии 1.1 заменено на processMouseMotionEvent(MouseEvent).
boolean mouseEnter(Event evt, int x, int y)
Устарело.
Начиная с JDK версии 1.1 заменено на processMouseEvent(MouseEvent).
boolean mouseExit(Event evt, int x, int y)
Устарело.
Начиная с JDK версии 1.1 заменено на processMouseEvent(MouseEvent).
boolean mouseMove(Event evt, int x, int y)
Устарело.
Начиная с JDK версии 1.1 заменено на processMouseMotionEvent(MouseEvent).
boolean mouseUp(Event evt, int x, int y)
Устарело.
Начиная с JDK версии 1.1 заменено на processMouseEvent(MouseEvent).
void move(int x, int y)
Устарело.
Начиная с JDK версии 1.1 заменено на setLocation(int, int).
void nextFocus()
Устарело.
Начиная с JDK версии 1.1 заменено на transferFocus().
void paint(Graphics g)
Рисует этот компонент.
void paintAll(Graphics g)
Рисует этот компонент и все его дочерние компоненты.
boolean postEvent(Event e)
Устарело.
Начиная с JDK версии 1.1 заменено на dispatchEvent(AWTEvent).
Dimension preferredSize()
Устарело.
Начиная с JDK версии 1.1 заменено на getPreferredSize().
boolean prepareImage(Image image, int width, int height, ImageObserver observer)
Подготавливает изображение к отображению в этом компоненте с указанными шириной и высотой.
boolean prepareImage(Image image, ImageObserver observer)
Подготавливает изображение для отображения в этом компоненте.
void print(Graphics g)
Печатает этот компонент.
void printAll(Graphics g)
Печатает этот компонент и все его подкомпоненты.
protected void processComponentEvent(ComponentEvent e)
Обрабатывает события компонента, происходящие в этом компоненте, отправляя их всем зарегистрированным объектам ComponentListener.
protected void processEvent(AWTEvent e)
Обрабатывает события, происходящие в этом компоненте.
protected void processFocusEvent(FocusEvent e)
Обрабатывает события фокуса, происходящие в этом компоненте, отправляя их всем зарегистрированным объектам FocusListener.
protected void processHierarchyBoundsEvent(HierarchyEvent e)
Обрабатывает события границ иерархии, происходящие в этом компоненте, отправляя их всем зарегистрированным объектам HierarchyBoundsListener.
protected void processHierarchyEvent(HierarchyEvent e)
Обрабатывает события иерархии, происходящие в этом компоненте, отправляя их всем зарегистрированным объектам HierarchyListener.
protected void processInputMethodEvent(InputMethodEvent e)
Обрабатывает события метода ввода, происходящие в этом компоненте, отправляя их всем зарегистрированным объектам InputMethodListener.
protected void processKeyEvent(KeyEvent e)
Обрабатывает события клавиатуры, происходящие в этом компоненте, отправляя их всем зарегистрированным объектам KeyListener.
protected void processMouseEvent(MouseEvent e)
Обрабатывает события мыши, происходящие в этом компоненте, отправляя их всем зарегистрированным объектам MouseListener.
protected void processMouseMotionEvent(MouseEvent e)
Обрабатывает события перемещения мыши, происходящие в этом компоненте, отправляя их всем зарегистрированным объектам MouseMotionListener.
protected void processMouseWheelEvent(MouseWheelEvent e)
Обрабатывает события колеса мыши, происходящие в этом компоненте, отправляя их всем зарегистрированным объектам MouseWheelListener.
void remove(MenuComponent popup)
Удаляет указанное всплывающее меню из компонента.
void removeComponentListener(ComponentListener l)
Удаляет указанный слушатель событий компонента, чтобы он больше не получал события компонента от этого компонента.
void removeFocusListener(FocusListener l)
Удаляет указанный слушатель фокуса, чтобы он больше не получал события фокуса от этого компонента.
void removeHierarchyBoundsListener(HierarchyBoundsListener l)
Удаляет указанный слушатель границ иерархии, чтобы он больше не получал события границ иерархии от этого компонента.
void removeHierarchyListener(HierarchyListener l)
Удаляет указанный слушатель иерархии, чтобы он больше не получал события изменения иерархии от этого компонента.
void removeInputMethodListener(InputMethodListener l)
Удаляет указанный слушатель метода ввода, чтобы он больше не получал события метода ввода от этого компонента.
void removeKeyListener(KeyListener l)
Удаляет указанный слушатель клавиатуры, чтобы он больше не получал события клавиатуры от этого компонента.
void removeMouseListener(MouseListener l)
Удаляет указанный слушатель мыши, чтобы он больше не получал события мыши от этого компонента.
void removeMouseMotionListener(MouseMotionListener l)
Удаляет указанный слушатель перемещения мыши, чтобы он больше не получал события перемещения мыши от этого компонента.
void removeMouseWheelListener(MouseWheelListener l)
Удаляет указанный слушатель колеса мыши, чтобы он больше не получал события колеса мыши от этого компонента.
void removeNotify()
Делает этот Component недоступным для отображения, уничтожая его собственный экранный ресурс.
void removePropertyChangeListener(PropertyChangeListener listener)
Удаляет PropertyChangeListener из списка слушателей.
void removePropertyChangeListener(String propertyName, PropertyChangeListener listener)
Удаляет PropertyChangeListener из списка слушателей для определённого свойства.
void repaint()
Перерисовывает этот компонент.
void repaint(int x, int y, int width, int height)
Перерисовывает указанный прямоугольник этого компонента.
void repaint(long tm)
Перерисовывает компонент.
void repaint(long tm, int x, int y, int width, int height)
Перерисовывает указанный прямоугольник этого компонента в течение tm миллисекунд.
void requestFocus()
Запрашивает передачу фокуса ввода этому компоненту и фокуса окну — его предку верхнего уровня.
protected boolean requestFocus(boolean temporary)
Запрашивает передачу фокуса ввода этому Component и фокуса Window — его предку верхнего уровня Component.
protected boolean requestFocus(boolean temporary, FocusEvent.Cause cause)
Запрашивает по причине cause передачу фокуса ввода этому Component и фокуса Window — его предку верхнего уровня Component.
void requestFocus(FocusEvent.Cause cause)
Запрашивает по причине cause передачу фокуса ввода этому компоненту и фокуса окну — его предку верхнего уровня.
boolean requestFocusInWindow()
Запрашивает передачу фокуса ввода этому компоненту, если окно — его предок верхнего уровня — уже находится в фокусе.
protected boolean requestFocusInWindow(boolean temporary)
Запрашивает передачу фокуса ввода этому Component, если Window — его предок верхнего уровня Component — уже находится в фокусе.
boolean requestFocusInWindow(FocusEvent.Cause cause)
Запрашивает по причине cause передачу фокуса ввода этому компоненту, если окно — его предок верхнего уровня — уже находится в фокусе.
void reshape(int x, int y, int width, int height)
Устарело.
Начиная с JDK версии 1.1 заменено на setBounds(int, int, int, int).
void resize(int width, int height)
Устарело.
Начиная с JDK версии 1.1 заменено на setSize(int, int).
void resize(Dimension d)
Устарело.
Начиная с JDK версии 1.1 заменено на setSize(Dimension).
void revalidate()
Повторно проверяет иерархию компонентов вплоть до ближайшего корня проверки.
void setBackground(Color c)
Задаёт цвет фона этого компонента.
void setBounds(int x, int y, int width, int height)
Перемещает этот компонент и изменяет его размер.
void setBounds(Rectangle r)
Перемещает этот компонент и изменяет его размер в соответствии с новым ограничивающим прямоугольником r.
void setComponentOrientation(ComponentOrientation o)
Задаёт языковую ориентацию, используемую для упорядочения элементов или текста внутри этого компонента.
void setCursor(Cursor cursor)
Задаёт указанное изображение курсора.
void setDropTarget(DropTarget dt)
Связывает DropTarget с этим компонентом.
void setEnabled(boolean b)
Включает или отключает этот компонент в зависимости от значения параметра b.
void setFocusable(boolean focusable)
Задаёт для компонента возможность получения фокуса указанное значение.
void setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)
Задаёт клавиши перехода фокуса для указанной операции перехода фокуса этого компонента.
void setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)
Задаёт, включены ли клавиши перехода фокуса для этого компонента.
void setFont(Font f)
Задаёт шрифт этого компонента.
void setForeground(Color c)
Задаёт цвет переднего плана этого компонента.
void setIgnoreRepaint(boolean ignoreRepaint)
Задаёт, следует ли игнорировать сообщения отрисовки, полученные от операционной системы.
void setLocale(Locale l)
Задаёт локаль этого компонента.
void setLocation(int x, int y)
Перемещает этот компонент в новое место.
void setLocation(Point p)
Перемещает этот компонент в новое место.
void setMaximumSize(Dimension maximumSize)
Задаёт постоянный максимальный размер этого компонента.
void setMinimumSize(Dimension minimumSize)
Задаёт постоянный минимальный размер этого компонента.
void setMixingCutoutShape(Shape shape)
Задаёт форму «mixing-cutout» для этого облегчённого компонента.
void setName(String name)
Задаёт имя компонента указанной строкой.
void setPreferredSize(Dimension preferredSize)
Задаёт постоянный предпочтительный размер этого компонента.
void setSize(int width, int height)
Изменяет размер этого компонента так, чтобы его ширина составляла width, а высота — height.
void setSize(Dimension d)
Изменяет размер этого компонента так, чтобы его ширина составляла d.width, а высота — d.height.
void setVisible(boolean b)
Показывает или скрывает этот компонент в зависимости от значения параметра b.
void show()
Устарело.
Начиная с JDK версии 1.1 заменено на setVisible(boolean).
void show(boolean b)
Устарело.
Начиная с JDK версии 1.1 заменено на setVisible(boolean).
Dimension size()
Устарело.
Начиная с JDK версии 1.1 заменено на getSize().
String toString()
Возвращает строковое представление этого компонента и его значений.
void transferFocus()
Передаёт фокус следующему компоненту, как если бы этот компонент находился в фокусе.
void transferFocusBackward()
Передаёт фокус предыдущему компоненту, как если бы этот компонент находился в фокусе.
void transferFocusUpCycle()
Передаёт фокус на один цикл перехода фокуса вверх.
void update(Graphics g)
Обновляет этот компонент.
void validate()
Проверяет этот компонент.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Модификатор и тип Метод Описание
protected Object clone()
Создает и возвращает копию этого объекта.
boolean equals(Object obj)
Указывает, равен ли какой-либо другой объект этому объекту.
protected void finalize()
Устарело, планируется удаление: этот элемент API подлежит удалению в будущей версии.
Финализация устарела и подлежит удалению в одном из будущих выпусков.
final Class<?> getClass()
Возвращает класс времени выполнения этого Object.
int hashCode()
Возвращает значение хеш-кода для этого объекта.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
final void wait()
Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного периода реального времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного периода реального времени.

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

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.
См. также:
  • 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(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

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, концептуальные обзоры, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2026, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API