Spec-Zone.ru › OpenJDK 17

Класс JLabel

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
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
Класс, используемый для получения доступной роли для этого объекта.

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

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

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

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

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

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

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

Поля, объявленные в интерфейсе javax.swing.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)
Проверка, является ли ключ допустимым значением для свойств horizontalAlignment.
protected int checkVerticalKey(int key, String message)
Проверка, является ли ключ допустимым значением для свойств 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)
Это переопределяется, чтобы вернуть false, если текущее изображение значка не равно переданному изображению img.
protected String paramString()
Возвращает строковое представление этого JLabel.
void setDisabledIcon(Icon disabledIcon)
Устанавливает значок, отображаемый, если этот JLabel «отключён» (JLabel.setEnabled(false)).
void setDisplayedMnemonic(char aChar)
Устанавливает отображаемый символ-мнемонику как значение типа 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 до значения из текущего визуального стиля.

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

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

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

Методы, объявленные в классе java.lang.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()
Возвращает объект L&F, который отображает этот компонент.
Переопределяет:
getUI в классе JComponent
Возвращает:
Объект LabelUI

setUI

@BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the Component\'s LookAndFeel.") public void setUI(LabelUI ui)
Устанавливает объект L&F, который отображает этот компонент.
Параметры:
ui - объект LabelUI L&F
См. также:
  • UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()
Сбрасывает свойство UI на значение из текущего стиля отображения.
Переопределяет:
updateUI в классе JComponent
См. также:
  • JComponent.updateUI()

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()
Возвращает строку, которая указывает имя класса l&f, отображающего этот компонент.
Переопределяет:
getUIClassID в классе JComponent
Возвращает:
строку "LabelUI"
См. также:
  • JComponent.getUIClassID()
  • UIDefaults.getUI(javax.swing.JComponent)

getText

public String getText()
Возвращает строку текста, отображаемого меткой.
Возвращает:
строку String
См. также:
  • setText(java.lang.String)

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 - строка текста, которая будет отображаться этим компонентом
См. также:
  • setVerticalTextPosition(int)
  • setHorizontalTextPosition(int)
  • setIcon(javax.swing.Icon)

getIcon

public Icon getIcon()
Возвращает графическое изображение (символ, иконку), отображаемое меткой.
Возвращает:
иконку Icon
См. также:
  • setIcon(javax.swing.Icon)

setIcon

@BeanProperty(preferred=true, visualUpdate=true, description="The icon this component will display.") public void setIcon(Icon icon)
Определяет иконку, которая будет отображаться этим компонентом. Если значение иконки равно null, ничего не отображается.

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

Это свойство JavaBeans, привязанное к данным.

Параметры:
icon - отображаемая иконка
См. также:
  • setVerticalTextPosition(int)
  • setHorizontalTextPosition(int)
  • getIcon()

getDisabledIcon

public Icon getDisabledIcon()
Возвращает иконку, используемую меткой, когда она отключена. Если отключённая иконка не установлена, вызов передается стилю отображения для построения соответствующей отключённой иконки.

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

Возвращает:
свойство disabledIcon
См. также:
  • setDisabledIcon(javax.swing.Icon)
  • LookAndFeel.getDisabledIcon(javax.swing.JComponent, javax.swing.Icon)
  • ImageIcon

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 - иконка, которая будет отображаться, когда компонент отключён
См. также:
  • getDisabledIcon()
  • JComponent.setEnabled(boolean)

setDisplayedMnemonic

@BeanProperty(visualUpdate=true, description="The mnemonic keycode.") public void setDisplayedMnemonic(int key)
Указывает код клавиши, являющейся мнемонической. Это свойство используется, когда метка является частью более крупного компонента. Если свойство labelFor метки не равно null, метка вызовет метод requestFocus у компонента, указанного свойством labelFor, при активации мнемонической клавиши.
Параметры:
key - код клавиши, являющейся мнемонической
См. также:
  • getLabelFor()
  • setLabelFor(java.awt.Component)

setDisplayedMnemonic

public void setDisplayedMnemonic(char aChar)
Устанавливает displayedMnemonic в виде значения char.
Параметры:
aChar - char, определяющий мнемоническую клавишу для отображения
См. также:
  • setDisplayedMnemonic(int)

getDisplayedMnemonic

public int getDisplayedMnemonic()
Возвращает код клавиши, являющейся мнемонической. Это свойство используется, когда метка является частью более крупного компонента. Если свойство labelFor метки не равно null, метка вызовет метод requestFocus у компонента, указанного свойством labelFor, при активации мнемонической клавиши.
Возвращает:
целое значение для мнемонической клавиши
См. также:
  • getLabelFor()
  • setLabelFor(java.awt.Component)
END_OF_DOCUMENT_MARKER

Установить индекс отображаемого мнемоника

@BeanProperty(visualUpdate=true, description="the index into the String to draw the keyboard character mnemonic at") public void setDisplayedMnemonicIndex(int index) throws IllegalArgumentException
Предоставляет подсказку для внешнего вида о том, какой символ в тексте следует оформить, чтобы представить мнемонический символ. Не все внешние виды могут поддерживать это. Значение -1 указывает либо на отсутствие мнемоники, либо на то, что мнемоника не содержится в строке, либо разработчик не хочет отображать мнемонику.

Значение обновляется по мере изменения свойств, относящихся к мнемонике (таких как мнемоника сама по себе, текст...). Вы должны вызывать этот метод только в том случае, если вы не хотите, чтобы символ по умолчанию был подчеркнут. Например, если текст был 'Сохранить как', с мнемоником 'a', и вы хотели, чтобы 'A' был оформлен, как 'Сохранить Aс', вам пришлось бы вызвать setDisplayedMnemonicIndex(5) после вызова setDisplayedMnemonic(KeyEvent.VK_A).

Параметры:
index - Индекс в строке для подчеркивания
Исключение:
IllegalArgumentException - будет выброшено, если index больше или равно длине текста или меньше -1
С:
1.4

Получить индекс отображаемого мнемоника

public int getDisplayedMnemonicIndex()
Возвращает символ, как индекс, для которого внешний вид должен обеспечить оформление, представляющее мнемонический символ.
Возвращает:
индекс, представляющий мнемонический символ
С:
1.4
См. также:
  • setDisplayedMnemonicIndex(int)

проверитьГоризонтальныйКлюч

protected int checkHorizontalKey(int key, String message)
Проверка, является ли ключ допустимым значением для свойств horizontalAlignment.
Параметры:
key - проверяемое значение свойства
message - сообщение об ошибке IllegalArgumentException
Возвращает:
значение ключа, если key является допустимым значением для свойств horizontalAlignment
Исключение:
IllegalArgumentException - если ключ не LEFT, CENTER, RIGHT, LEADING или TRAILING.
См. также:
  • setHorizontalTextPosition(int)
  • setHorizontalAlignment(int)

проверитьВертикальныйКлюч

protected int checkVerticalKey(int key, String message)
Проверка, является ли ключ допустимым значением для свойств verticalAlignment или verticalTextPosition.
Параметры:
key - проверяемое значение свойства
message - сообщение об ошибке IllegalArgumentException
Возвращает:
значение ключа, если key является допустимым значением для свойств verticalAlignment или verticalTextPosition
Исключение:
IllegalArgumentException - если ключ не TOP, CENTER или BOTTOM.
См. также:
  • setVerticalAlignment(int)
  • setVerticalTextPosition(int)

Получить зазор между иконкой и текстом

public int getIconTextGap()
Возвращает величину пространства между текстом и иконкой, отображаемыми в этом метке.
Возвращает:
целое число, равное количеству пикселей между текстом и иконкой.
См. также:
  • setIconTextGap(int)

Установить зазор между иконкой и текстом

@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 - расстояние между свойствами иконки и текста
См. также:
  • getIconTextGap()

Получить вертикальное выравнивание

public int getVerticalAlignment()
Возвращает выравнивание содержимого метки по оси Y.
Возвращает:
Значение свойства verticalAlignment, одно из следующих констант, определенных в SwingConstants: TOP, CENTER, или BOTTOM.
См. также:
  • SwingConstants
  • setVerticalAlignment(int)

Установить вертикальное выравнивание

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

Получить горизонтальное выравнивание

public int getHorizontalAlignment()
Возвращает выравнивание содержимого метки по оси X.
Возвращает:
Значение свойства horizontalAlignment, одно из следующих констант, определенных в SwingConstants: LEFT, CENTER, RIGHT, LEADING или TRAILING.
См. также:
  • setHorizontalAlignment(int)
  • SwingConstants

Установить горизонтальное выравнивание

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

Получить вертикальное положение текста

public int getVerticalTextPosition()
Возвращает вертикальное положение текста метки относительно её изображения.
Возвращает:
Одно из следующих констант, определенных в SwingConstants: TOP, CENTER, или BOTTOM.
См. также:
  • setVerticalTextPosition(int)
  • SwingConstants

Установить вертикальное положение текста

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

Получить горизонтальное положение текста

public int getHorizontalTextPosition()
Возвращает горизонтальное положение текста метки относительно её изображения.
Возвращает:
Одно из следующих констант, определенных в SwingConstants: LEFT, CENTER, RIGHT, LEADING или TRAILING.
См. также:
  • SwingConstants

Установить горизонтальное положение текста

@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 (значение по умолчанию).
См. также:
  • SwingConstants

imageUpdate

public boolean imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
Этот метод переопределён, чтобы вернуть false, если текущее изображение иконки не равно переданному изображению img.
Унаследованно от:
imageUpdate в интерфейсе ImageObserver
Переопределяет:
imageUpdate в классе Component
Параметры:
img - наблюдаемое изображение
infoflags - см. imageUpdate для дополнительной информации
x - координата x
y - координата y
w - ширина
h - высота
Возвращает:
false если флаги информируют о том, что изображение полностью загружено; true в противном случае.
См. также:
  • ImageObserver
  • Component.imageUpdate(java.awt.Image, int, int, int, int, int)

paramString

protected String paramString()
Возвращает строковое представление этого JLabel. Данный метод предназначен только для отладки, и содержимое и формат возвращаемой строки могут варьироваться между реализациями. Возвращаемая строка может быть пустой, но не может быть null.
Overrides:
paramString в классе JComponent
Возвращает:
строковое представление этого JLabel.

getLabelFor

public Component getLabelFor()
Получить компонент, который этот JLabel подписывает.
Возвращает:
компонент, который этот JLabel подписывает. Может быть null, если этот JLabel не подписывает компонент. Если свойство displayedMnemonic установлено, а свойство labelFor также установлено, метка вызовет метод requestFocus у компонента, указанного свойством labelFor, когда будет активирован мнемоник.
См. также:
  • getDisplayedMnemonic()
  • setDisplayedMnemonic(int)

setLabelFor

@BeanProperty(description="The component this is labelling.") public void setLabelFor(Component c)
Установить компонент, который этот JLabel подписывает. Может быть null, если этот JLabel не подписывает компонент. Если свойство displayedMnemonic установлено, а свойство labelFor также установлено, метка вызовет метод requestFocus у компонента, указанного свойством labelFor, когда будет активирован мнемоник.
Параметры:
c - компонент, для которого предназначен этот JLabel, или null, если метка не предназначена для компонента
См. также:
  • getDisplayedMnemonic()
  • setDisplayedMnemonic(int)

getAccessibleContext

@BeanProperty(bound=false, expert=true, description="The AccessibleContext associated with this Label.") public AccessibleContext getAccessibleContext()
Получить AccessibleContext этого объекта
Определено в:
getAccessibleContext в интерфейсе Accessible
Overrides:
getAccessibleContext в классе Component
Возвращает:
AccessibleContext этого объекта

© 1993, 2021, 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/17/docs/api/java.desktop/javax/swing/JLabel.html

Spec-Zone.ru

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