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

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

Modifier and Type	Class	Description
`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

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

Modifier and Type	Field	Description
`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` со указанным изображением и выравниванием по горизонтали.

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

Modifier and Type	Метод	Описание
`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)`	Если компонент не отображается, или значок или отключённый значок не являются `ImageIcon` с `Image` равным переданному `Image`, возвратить `false`; иначе делегирует в суперкласс.
`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 - объект L&F LabelUI

См. также:

updateUI

public void updateUI()

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

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

updateUI в классе JComponent

См. также:

getUIClassID

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

Возвращает строку, указывающую имя класса l&f, который отрисовывает этот компонент.

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

getUIClassID в классе JComponent

Возвращает:

строку "LabelUI"

См. также:

getText

public String getText()

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

Возвращает:

строку 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 - строка текста, который будет отображать этот компонент

См. также:

getIcon

public Icon getIcon()

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

Возвращает:

объект Icon

См. также:

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 - символ, представляющий отображаемую мнемонику

См. также:

END_OF_DOCUMENT_MARKER

getDisplayedMnemonic

public int getDisplayedMnemonic()

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

Возвращает:

целочисленное значение для клавиши мнемоники

См. также:

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

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

Параметры:

key - значение свойства для проверки

message - сообщение об ошибке IllegalArgumentException

Возвращает:

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

Исключения:

IllegalArgumentException - если ключ не равен LEFT, CENTER, RIGHT, LEADING или TRAILING.

См. также:

checkVerticalKey

protected int checkVerticalKey(int key, String message)

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

Параметры:

key - значение свойства для проверки

message - сообщение об ошибке IllegalArgumentException

Возвращает:

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

Исключения:

IllegalArgumentException - если ключ не равен TOP, CENTER или BOTTOM.

См. также:

getIconTextGap

public int getIconTextGap()

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

Возвращает:

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

См. также:

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; в противном случае делегировать в суперкласс.

Specified by:

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

Overrides:

imageUpdate в классе Component

Parameters:

img - сравниваемый Image

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

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

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

w - ширина

h - высота

Returns:

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

See Also:

paramString

protected String paramString()

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

Overrides:: paramString в классе JComponent
Returns:: строковое представление этого JLabel.

getLabelFor

public Component getLabelFor()

Получить компонент, который эта метка описывает.

Returns:

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

See Also:

setLabelFor

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

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

Parameters:

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

See Also:

getAccessibleContext

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

Получить AccessibleContext этого объекта

Specified by:: getAccessibleContext в интерфейсе Accessible
Overrides:: getAccessibleContext в классе Component
Returns:: 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/JLabel.html