Класс JLabel

javax.swing.JLabel

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

Прямые известные подклассы:: BasicComboBoxRenderer, DefaultListCellRenderer, DefaultTableCellRenderer, DefaultTreeCellRenderer

@JavaBean(defaultProperty="UI", description="A component that displays a short string and an icon.") public class JLabel extends JComponent implements SwingConstants, Accessible

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

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

Также можно указать положение текста относительно изображения. По умолчанию текст располагается у конечной границы изображения, а текст и изображение выравниваются по вертикали.

Начальная и конечная границы метки определяются значением её свойства ComponentOrientation. В настоящее время настройка ComponentOrientation по умолчанию сопоставляет начальную границу с левой, а конечную — с правой.

Наконец, можно использовать метод setIconTextGap, чтобы указать, сколько пикселей должно быть между текстом и изображением. Значение по умолчанию — 4 пикселя.

Дополнительную документацию см. в разделе Как использовать метки в учебнике по Java.

Предупреждение: Swing не является потокобезопасным. Дополнительные сведения см. в разделе Политика работы с потоками в Swing.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими выпусками Swing. Текущая поддержка сериализации подходит для кратковременного хранения или RMI между приложениями, работающими с одной и той же версией Swing. Начиная с версии 1.4, поддержка долговременного хранения всех JavaBeans добавлена в пакет java.beans. См. XMLEncoder.

Начиная с версии:: 1.2

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

Модификатор и тип	Класс	Описание
`protected class`	`JLabel.AccessibleJLabel`	Класс, используемый для получения доступной роли этого объекта.

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

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

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

Модификатор и тип	Поле	Описание
`protected Component`	`labelFor`	Компонент, для которого предназначена эта метка; null, если метка не является меткой для какого-либо компонента

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

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

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

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

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

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

Конструктор	Описание
`JLabel()`	Создаёт экземпляр `JLabel` без изображения и с пустой строкой в качестве заголовка.
`JLabel(String text)`	Создаёт экземпляр `JLabel` с указанным текстом.
`JLabel(String text, int horizontalAlignment)`	Создаёт экземпляр `JLabel` с указанным текстом и горизонтальным выравниванием.
`JLabel(String text, Icon icon, int horizontalAlignment)`	Создаёт экземпляр `JLabel` с указанными текстом, изображением и горизонтальным выравниванием.
`JLabel(Icon image)`	Создаёт экземпляр `JLabel` с указанным изображением.
`JLabel(Icon image, int horizontalAlignment)`	Создаёт экземпляр `JLabel` с указанными изображением и горизонтальным выравниванием.

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

Модификатор и тип	Метод	Описание
`protected int`	`checkHorizontalKey(int key, String message)`	Проверяет, является ли key допустимым значением для свойств horizontalAlignment.
`protected int`	`checkVerticalKey(int key, String message)`	Проверяет, является ли key допустимым значением для свойств verticalAlignment или verticalTextPosition.
`AccessibleContext`	`getAccessibleContext()`	Получает AccessibleContext этого объекта
`Icon`	`getDisabledIcon()`	Возвращает значок, используемый меткой, когда она отключена.
`int`	`getDisplayedMnemonic()`	Возвращает код клавиши, обозначающей мнемоническую клавишу.
`int`	`getDisplayedMnemonicIndex()`	Возвращает символ в виде индекса, для которого внешний вид должен предусмотреть оформление как для мнемонического символа.
`int`	`getHorizontalAlignment()`	Возвращает выравнивание содержимого метки вдоль оси X.
`int`	`getHorizontalTextPosition()`	Возвращает горизонтальное положение текста метки относительно изображения.
`Icon`	`getIcon()`	Возвращает графическое изображение (глиф, значок), отображаемое меткой.
`int`	`getIconTextGap()`	Возвращает расстояние между текстом и значком, отображаемыми в этой метке.
`Component`	`getLabelFor()`	Получает компонент, которому соответствует эта метка.
`String`	`getText()`	Возвращает текстовую строку, отображаемую меткой.
`LabelUI`	`getUI()`	Возвращает объект L&F, который отрисовывает этот компонент.
`String`	`getUIClassID()`	Возвращает строку с именем класса l&f, который отрисовывает этот компонент.
`int`	`getVerticalAlignment()`	Возвращает выравнивание содержимого метки вдоль оси Y.
`int`	`getVerticalTextPosition()`	Возвращает вертикальное положение текста метки относительно изображения.
`boolean`	`imageUpdate(Image img, int infoflags, int x, int y, int w, int h)`	Если компонент не отображается или значок либо отключённый значок не является `ImageIcon` с `Image`, равным переданному `Image`, возвращает `false`; в противном случае делегирует вызов суперклассу.
`protected String`	`paramString()`	Возвращает строковое представление этого JLabel.
`void`	`setDisabledIcon(Icon disabledIcon)`	Задаёт значок, который будет отображаться, если этот JLabel «отключён» (JLabel.setEnabled(false)).
`void`	`setDisplayedMnemonic(char aChar)`	Задаёт displayedMnemonic в виде значения типа char.
`void`	`setDisplayedMnemonic(int key)`	Задаёт код клавиши, обозначающей мнемоническую клавишу.
`void`	`setDisplayedMnemonicIndex(int index)`	Предоставляет внешнему виду подсказку о том, какой символ в тексте следует оформить как мнемонический.
`void`	`setHorizontalAlignment(int alignment)`	Задаёт выравнивание содержимого метки вдоль оси X.
`void`	`setHorizontalTextPosition(int textPosition)`	Задаёт горизонтальное положение текста метки относительно изображения.
`void`	`setIcon(Icon icon)`	Задаёт значок, отображаемый этим компонентом.
`void`	`setIconTextGap(int iconTextGap)`	Если заданы свойства значка и текста, это свойство определяет расстояние между ними.
`void`	`setLabelFor(Component c)`	Задаёт компонент, которому соответствует эта метка.
`void`	`setText(String text)`	Задаёт единственную строку текста, отображаемую этим компонентом.
`void`	`setUI(LabelUI ui)`	Задаёт объект L&F, который отрисовывает этот компонент.
`void`	`setVerticalAlignment(int alignment)`	Задаёт выравнивание содержимого метки вдоль оси Y.
`void`	`setVerticalTextPosition(int textPosition)`	Задаёт вертикальное положение текста метки относительно изображения.
`void`	`updateUI()`	Сбрасывает свойство UI до значения из текущего внешнего вида.

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

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

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

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

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

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

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

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

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

labelFor

protected Component labelFor

Компонент, для которого предназначена эта метка; null, если метка не связана с компонентом

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

JLabel

public JLabel(String text, Icon icon, int horizontalAlignment)

Создает экземпляр JLabel с указанными текстом, изображением и горизонтальным выравниванием. Метка выравнивается по центру вертикально в своей области отображения. Текст располагается у правого края изображения.

Параметры:: text — текст, отображаемый меткой.; icon — изображение, отображаемое меткой.; horizontalAlignment — одна из следующих констант, определенных в SwingConstants: LEFT, CENTER, RIGHT, LEADING или TRAILING.

JLabel

public JLabel(String text, int horizontalAlignment)

Создает экземпляр JLabel с указанными текстом и горизонтальным выравниванием. Метка выравнивается по центру вертикально в своей области отображения.

Параметры:: text — текст, отображаемый меткой.; horizontalAlignment — одна из следующих констант, определенных в SwingConstants: LEFT, CENTER, RIGHT, LEADING или TRAILING.

JLabel

public JLabel(String text)

Создает экземпляр JLabel с указанным текстом. Метка выравнивается по ведущему краю области отображения и по центру вертикально.

Параметры:: text — текст, отображаемый меткой.

JLabel

public JLabel(Icon image, int horizontalAlignment)

Создает экземпляр JLabel с указанным изображением и горизонтальным выравниванием. Метка выравнивается по центру вертикально в своей области отображения.

Параметры:: image — изображение, отображаемое меткой.; horizontalAlignment — одна из следующих констант, определенных в SwingConstants: LEFT, CENTER, RIGHT, LEADING или TRAILING.

JLabel

public JLabel(Icon image)

Создает экземпляр JLabel с указанным изображением. Метка выравнивается по центру вертикально и горизонтально в своей области отображения.

Параметры:: image — изображение, отображаемое меткой.

JLabel

public JLabel()

Создает экземпляр JLabel без изображения и с пустой строкой в качестве заголовка. Метка выравнивается по центру вертикально в своей области отображения. После задания содержимое метки будет отображаться у ее ведущего края.

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

getUI

public LabelUI getUI()

Возвращает объект оформления, который отображает этот компонент.

Переопределяет:: getUI в классе JComponent
Возвращает:: объект LabelUI

setUI

@BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the Component's LookAndFeel.") public void setUI(LabelUI ui)

Задает объект оформления, который отображает этот компонент.

Параметры:

ui — объект оформления LabelUI

См. также:

updateUI

public void updateUI()

Сбрасывает свойство UI до значения из текущего оформления.

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

updateUI в классе JComponent

См. также:

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()

Возвращает строку, задающую имя класса оформления, который отображает этот компонент.

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

getUIClassID в классе JComponent

Возвращает:

строку "LabelUI"

См. также:

getText

public String getText()

Возвращает текстовую строку, отображаемую меткой.

Возвращает:

строку

См. также:

setText

@BeanProperty(preferred=true, visualUpdate=true, description="Defines the single line of text this component will display.") public void setText(String text)

Задает единственную строку текста, отображаемую этим компонентом. Если значение текста равно null или представляет собой пустую строку, ничего не отображается.

Значение этого свойства по умолчанию — null.

Это связанное свойство JavaBeans.

Параметры:

text — единственная строка текста, отображаемая этим компонентом

См. также:

getIcon

public Icon getIcon()

Возвращает графическое изображение (глиф, значок), отображаемое меткой.

Возвращает:

значок

См. также:

setIcon

@BeanProperty(preferred=true, visualUpdate=true, description="The icon this component will display.") public void setIcon(Icon icon)

Задает значок, отображаемый этим компонентом. Если значение значка равно null, ничего не отображается.

Значение этого свойства по умолчанию — null.

Это связанное свойство JavaBeans.

Параметры:

icon — значок по умолчанию, отображаемый этим компонентом

См. также:

getDisabledIcon

public Icon getDisabledIcon()

Возвращает значок, используемый меткой, когда она отключена. Если отключенный значок не задан, этот вызов будет передан оформлению, чтобы создать подходящий отключенный значок.

Некоторые оформления могут не отображать отключенный значок; в таком случае они проигнорируют это свойство.

Возвращает:

свойство disabledIcon

См. также:

setDisabledIcon

@BeanProperty(visualUpdate=true, description="The icon to display if the label is disabled.") public void setDisabledIcon(Icon disabledIcon)

Задает значок, отображаемый, если этот JLabel отключен (JLabel.setEnabled(false)).

Значение этого свойства по умолчанию — null.

Параметры:

disabledIcon — значок, отображаемый, когда компонент отключен

См. также:

setDisplayedMnemonic

@BeanProperty(visualUpdate=true, description="The mnemonic keycode.") public void setDisplayedMnemonic(int key)

Задает код клавиши, обозначающей мнемоническую клавишу. Это свойство используется, когда метка является частью более крупного компонента. Если свойство labelFor метки не равно null, при активации мнемонической клавиши метка вызовет метод requestFocus компонента, указанного свойством labelFor.

Параметры:

key — код клавиши, обозначающей мнемоническую клавишу

См. также:

setDisplayedMnemonic

public void setDisplayedMnemonic(char aChar)

Задает displayedMnemonic в виде значения char.

Параметры:

aChar — символ char, задающий отображаемую мнемоническую клавишу

См. также:

getDisplayedMnemonic

public int getDisplayedMnemonic()

Возвращает код клавиши, обозначающей мнемоническую клавишу. Это свойство используется, когда метка является частью более крупного компонента. Если свойство labelFor метки не равно null, при активации мнемонической клавиши метка вызовет метод requestFocus компонента, указанного свойством labelFor.

Возвращает:

значение int, соответствующее мнемонической клавише

См. также:

setDisplayedMnemonicIndex

@BeanProperty(visualUpdate=true, description="the index into the String to draw the keyboard character mnemonic at") public void setDisplayedMnemonicIndex(int index) throws IllegalArgumentException

Указывает оформлению, какой символ в тексте следует выделить, чтобы обозначить мнемоническую клавишу. Не все оформления поддерживают эту функцию. Значение -1 означает, что мнемоническая клавиша не задана, ее символ отсутствует в строке или разработчик не хочет отображать ее обозначение.

Это значение обновляется при изменении свойств, связанных с мнемонической клавишей (например, самой мнемонической клавиши, текста...). Вызывать этот метод нужно только в том случае, если вы не хотите, чтобы подчеркивался символ по умолчанию. Например, если текст — «Save As», мнемоническая клавиша — «a», и нужно выделить «A», как в «Save As», следует вызвать setDisplayedMnemonicIndex(5) после вызова setDisplayedMnemonic(KeyEvent.VK_A).

Параметры:: index — индекс символа в строке, который нужно подчеркнуть
Исключения:: IllegalArgumentException — возникает, если index >= длины текста или < -1
С версии:: 1.4

getDisplayedMnemonicIndex

public int getDisplayedMnemonicIndex()

Возвращает индекс символа, который оформление должно выделить как символ мнемонической клавиши.

Возвращает:

индекс символа мнемонической клавиши

С версии:

1.4

См. также:

checkHorizontalKey

protected int checkHorizontalKey(int key, String message)

Проверяет, является ли key допустимым значением для свойств horizontalAlignment.

Параметры:

key — проверяемое значение свойства

message — подробное сообщение IllegalArgumentException

Возвращает:

значение key, если key является допустимым значением для свойств horizontalAlignment

Исключения:

IllegalArgumentException — если key не равен LEFT, CENTER, RIGHT, LEADING или TRAILING.

См. также:

checkVerticalKey

protected int checkVerticalKey(int key, String message)

Проверяет, является ли key допустимым значением для свойств verticalAlignment или verticalTextPosition.

Параметры:

key — проверяемое значение свойства

message — подробное сообщение IllegalArgumentException

Возвращает:

значение key, если key является допустимым значением для свойств verticalAlignment или verticalTextPosition

Исключения:

IllegalArgumentException — если key не равен TOP, CENTER или BOTTOM.

См. также:

getIconTextGap

public int getIconTextGap()

Возвращает расстояние между текстом и значком, отображаемыми этой меткой.

Возвращает:

значение int, равное количеству пикселей между текстом и значком.

См. также:

setIconTextGap

@BeanProperty(visualUpdate=true, description="If both the icon and text properties are set, this property defines the space between them.") public void setIconTextGap(int iconTextGap)

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

Значение этого свойства по умолчанию — 4 пикселя.

Это связанное свойство JavaBeans.

Параметры:

iconTextGap — расстояние между значком и текстом

См. также:

getVerticalAlignment

public int getVerticalAlignment()

Возвращает выравнивание содержимого метки по оси Y.

Возвращает:

значение свойства verticalAlignment — одну из следующих констант, определенных в SwingConstants: TOP, CENTER или BOTTOM.

См. также:

setVerticalAlignment

@BeanProperty(visualUpdate=true, enumerationValues={"SwingConstants.TOP","SwingConstants.CENTER","SwingConstants.BOTTOM"}, description="The alignment of the label's contents along the Y axis.") public void setVerticalAlignment(int alignment)

Задает выравнивание содержимого метки по оси Y.

Значение этого свойства по умолчанию — CENTER.

Параметры:

alignment — одна из следующих констант, определенных в SwingConstants: TOP, CENTER (значение по умолчанию) или BOTTOM.

См. также:

getHorizontalAlignment

public int getHorizontalAlignment()

Возвращает выравнивание содержимого метки по оси X.

Возвращает:

значение свойства horizontalAlignment — одну из следующих констант, определенных в SwingConstants: LEFT, CENTER, RIGHT, LEADING или TRAILING.

См. также:

setHorizontalAlignment

@BeanProperty(visualUpdate=true, enumerationValues={"SwingConstants.LEFT","SwingConstants.CENTER","SwingConstants.RIGHT","SwingConstants.LEADING","SwingConstants.TRAILING"}, description="The alignment of the label's content along the X axis.") public void setHorizontalAlignment(int alignment)

Задает выравнивание содержимого метки по оси X.

Это связанное свойство JavaBeans.

Параметры:

alignment — одна из следующих констант, определенных в SwingConstants: LEFT, CENTER (значение по умолчанию для меток только с изображением), RIGHT, LEADING (значение по умолчанию для меток только с текстом) или TRAILING.

См. также:

getVerticalTextPosition

public int getVerticalTextPosition()

Возвращает вертикальное положение текста метки относительно ее изображения.

Возвращает:

одну из следующих констант, определенных в SwingConstants: TOP, CENTER или BOTTOM.

См. также:

setVerticalTextPosition

@BeanProperty(expert=true, visualUpdate=true, enumerationValues={"SwingConstants.TOP","SwingConstants.CENTER","SwingConstants.BOTTOM"}, description="The vertical position of the text relative to it's image.") public void setVerticalTextPosition(int textPosition)

Задает вертикальное положение текста метки относительно ее изображения.

Значение этого свойства по умолчанию — CENTER.

Это связанное свойство JavaBeans.

Параметры:

textPosition — одна из следующих констант, определенных в SwingConstants: TOP, CENTER (значение по умолчанию) или BOTTOM.

См. также:

getHorizontalTextPosition

public int getHorizontalTextPosition()

Возвращает горизонтальное положение текста метки относительно ее изображения.

Возвращает:

одну из следующих констант, определенных в SwingConstants: LEFT, CENTER, RIGHT, LEADING или TRAILING.

См. также:

setHorizontalTextPosition

@BeanProperty(expert=true, visualUpdate=true, enumerationValues={"SwingConstants.LEFT","SwingConstants.CENTER","SwingConstants.RIGHT","SwingConstants.LEADING","SwingConstants.TRAILING"}, description="The horizontal position of the label's text, relative to its image.") public void setHorizontalTextPosition(int textPosition)

Задает горизонтальное положение текста метки относительно ее изображения.

Параметры:

textPosition — одна из следующих констант, определенных в SwingConstants: LEFT, CENTER, RIGHT, LEADING или TRAILING (значение по умолчанию).

См. также:

imageUpdate

public boolean imageUpdate(Image img, int infoflags, int x, int y, int w, int h)

Если компонент не отображается либо значок или отключенный значок не является ImageIcon с Image, равным переданному Image, возвращает false; в противном случае передает вызов суперклассу.

Определено в:

imageUpdate в интерфейсе ImageObserver

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

imageUpdate в классе Component

Параметры:

img — Image для сравнения

infoflags — флаги, используемые для перерисовки метки при обновлении изображения; они определяют область перерисовки

x — координата x

y — координата y

w — ширина

h — высота

Возвращает:

false, если infoflags указывает, что изображение полностью загружено; в противном случае — true.

См. также:

paramString

protected String paramString()

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

Переопределяет:: paramString в классе JComponent
Возвращает:: строковое представление этого JLabel.

getLabelFor

public Component getLabelFor()

Возвращает компонент, который помечает эта метка.

Возвращает:

компонент, который помечает эта метка. Может быть равен null, если метка не связана с компонентом. Если задано свойство displayedMnemonic и также задано свойство labelFor, при активации мнемонической клавиши метка вызовет метод requestFocus компонента, указанного свойством labelFor.

См. также:

setLabelFor

@BeanProperty(description="The component this is labelling.") public void setLabelFor(Component c)

Задает компонент, который помечает эта метка. Может быть равен null, если метка не связана с компонентом. Если задано свойство displayedMnemonic и также задано свойство labelFor, при активации мнемонической клавиши метка вызовет метод requestFocus компонента, указанного свойством labelFor.

Параметры:

c — компонент, для которого предназначена эта метка, или null, если метка не связана с компонентом

См. также:

getAccessibleContext

@BeanProperty(bound=false, expert=true, description="The AccessibleContext associated with this Label.") public AccessibleContext getAccessibleContext()

Возвращает AccessibleContext этого объекта

Определено в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе Component
Возвращает:: AccessibleContext этого объекта

© 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/javax/swing/JLabel.html