Spec-Zone.ru › OpenJDK 21

Класс 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()
Возвращает код клавиши, указывающий на клавишу mnemonics.
int getDisplayedMnemonicIndex()
Возвращает символ в качестве индекса, для которого вид и ощущения должны предоставить оформление, представляющее символ mnemonics.
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)
Указывает код клавиши, указывающий на клавишу mnemonics.
void setDisplayedMnemonicIndex(int index)
Предоставляет подсказку вид и ощущения о том, какой символ в тексте должен быть оформлен для представления символа mnemonics.
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)
Определяет строку текста, которая будет отображаться этим компонентом. Если значение 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)
Определяет значок, который будет отображаться этим компонентом. Если значение icon равно null, ничего не отображается.

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

Это свойство JavaBeans.

Параметры:
icon - значок, который будет отображаться этим компонентом по умолчанию
См. также:
  • setVerticalTextPosition(int)
  • setHorizontalTextPosition(int)
  • getIcon()

getDisabledIcon

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

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

Возвращает:
свойство 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 - символ, указывающий мнемоническую клавишу для отображения
См. также:
  • setDisplayedMnemonic(int)

getDisplayedMnemonic

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

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 указывает, что мнемоники нет, символ мнемоники не содержится в строке или разработчик не хочет отображать мнемонику.

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

Parameters:
index - Индекс в строке, который нужно подчеркнуть
Throws:
IllegalArgumentException - будет выброшено, если index больше или равен длине текста или меньше -1
Since:
1.4

getDisplayedMnemonicIndex

public int getDisplayedMnemonicIndex()
Возвращает символ, как индекс, который виджет должен оформить для отображения символа мнемоники.
Returns:
Индекс, представляющий символ мнемоники
Since:
1.4
See Also:
  • setDisplayedMnemonicIndex(int)

checkHorizontalKey

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

checkVerticalKey

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

getIconTextGap

public int getIconTextGap()
Возвращает расстояние между текстом и иконкой, отображаемыми в этом метке.
Returns:
целое число, равное количеству пикселей между текстом и иконкой.
See Also:
  • setIconTextGap(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.

Parameters:
iconTextGap - расстояние между свойствами иконки и текста
See Also:
  • getIconTextGap()

getVerticalAlignment

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

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.

Parameters:
alignment - Одно из следующих констант, определенных в SwingConstants: TOP, CENTER (значение по умолчанию), или BOTTOM.
See Also:
  • SwingConstants
  • getVerticalAlignment()

getHorizontalAlignment

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

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.

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

getVerticalTextPosition

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

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.

Parameters:
textPosition - Одно из следующих констант, определенных в SwingConstants: TOP, CENTER (значение по умолчанию), или BOTTOM.
See Also:
  • SwingConstants
  • getVerticalTextPosition()

getHorizontalTextPosition

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

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)
Устанавливает горизонтальное положение текста метки относительно изображения.
Parameters:
textPosition - Одно из следующих констант, определенных в SwingConstants: LEFT, CENTER, RIGHT, LEADING, или TRAILING (значение по умолчанию).
See Also:
  • SwingConstants

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 если флаги указывают, что изображение полностью загружено; true в противном случае.
См. также:
  • ImageObserver
  • Component.imageUpdate(java.awt.Image, int, int, int, int, int)

paramString

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

getLabelFor

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

setLabelFor

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

getAccessibleContext

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

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

Spec-Zone.ru

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