Spec-Zone.ru › OpenJDK 8

Класс BasicLabelUI

  • java.lang.Object
    • javax.swing.plaf.ComponentUI
      • javax.swing.plaf.LabelUI
        • javax.swing.plaf.basic.BasicLabelUI
Все реализованные интерфейсы:
PropertyChangeListener, EventListener
Непосредственные известные подклассы:
MetalLabelUI, SynthLabelUI

public class BasicLabelUI
extends LabelUI
implements PropertyChangeListener

Реализация LabelUI для Windows L&F. Эта реализация полностью статична, т.е. существует только одна реализация UIView, которая используется всеми объектами JLabel.

Поля

Модификатор и тип Поле и описание
protected static BasicLabelUI labelUI

Предопределённый экземпляр BasicLabelUI.

Конструкторы

Конструктор и описание
BasicLabelUI()

Методы

Модификатор и тип Метод и описание
static ComponentUI createUI(JComponent c)

Возвращает экземпляр BasicLabelUI.

int getBaseline(JComponent c, int width, int height)

Возвращает базовую линию.

Component.BaselineResizeBehavior getBaselineResizeBehavior(JComponent c)

Возвращает перечисление, указывающее, как изменяется базовая линия компонента при изменении размера.

Dimension getMaximumSize(JComponent c)

Возвращает максимальный размер указанного компонента, соответствующий выбранному стилю.

Dimension getMinimumSize(JComponent c)

Возвращает минимальный размер указанного компонента, соответствующий выбранному стилю.

Dimension getPreferredSize(JComponent c)

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

protected void installComponents(JLabel c)

Регистрирует компоненты.

protected void installDefaults(JLabel c)

Устанавливает значения по умолчанию.

protected void installKeyboardActions(JLabel l)

Регистрирует действия клавиатуры.

protected void installListeners(JLabel c)

Регистрирует слушателей.

void installUI(JComponent c)

Настраивает указанный компонент в соответствии с выбранным стилем.

protected String layoutCL(JLabel label, FontMetrics fontMetrics, String text, Icon icon, Rectangle viewR, Rectangle iconR, Rectangle textR)

Передает вызов методу SwingUtilities.layoutCompoundLabel().

void paint(Graphics g, JComponent c)

Рисует текст метки с цветом переднего плана, если метка непрозрачна, то рисует весь фон цветом фона.

protected void paintDisabledText(JLabel l, Graphics g, String s, int textX, int textY)

Рисует clippedText в координатах textX, textY цветом фона.lighter(), затем смещает вниз и вправо на один пиксель цветом фона.darker().

protected void paintEnabledText(JLabel l, Graphics g, String s, int textX, int textY)

Рисует clippedText в координатах textX, textY цветом переднего плана метки.

void propertyChange(PropertyChangeEvent e)

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

protected void uninstallComponents(JLabel c)

Отменяет регистрацию компонентов.

protected void uninstallDefaults(JLabel c)

Отменяет установку значений по умолчанию.

protected void uninstallKeyboardActions(JLabel c)

Отменяет регистрацию действий клавиатуры.

protected void uninstallListeners(JLabel c)

Отменяет регистрацию слушателей.

void uninstallUI(JComponent c)

Отменяет настройки, выполненные над указанным компонентом во время installUI.

Методы, унаследованные от класса javax.swing.plaf.ComponentUI

contains, getAccessibleChild, getAccessibleChildrenCount, update

Методы, унаследованные от класса java.lang.Object

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

Поля

labelUI

protected static BasicLabelUI labelUI

По умолчанию BasicLabelUI экземпляр. Это поле может не использоваться. Чтобы изменить экземпляр по умолчанию, используйте подкласс, который переопределяет метод createUI, и укажите имя этого класса в таблице defaults под ключом "LabelUI".

Конструкторы

BasicLabelUI

public BasicLabelUI()

Методы

layoutCL

protected String layoutCL(JLabel label,
                          FontMetrics fontMetrics,
                          String text,
                          Icon icon,
                          Rectangle viewR,
                          Rectangle iconR,
                          Rectangle textR)

Пересылает вызов SwingUtilities.layoutCompoundLabel(). Этот метод здесь для того, чтобы подкласс мог выполнить размещение, специфичное для метки, и для сокращения имени метода.

Параметры:
label - экземпляр JLabel
fontMetrics - метрика шрифта
text - текст
icon - значок
viewR - прямоугольник для размещения метки
iconR - прямоугольник для размещения значка
textR - прямоугольник для размещения текста
Возвращает:
возможно обрезанную версию строки составной метки
См. также:
SwingUtilities.layoutCompoundLabel(javax.swing.JComponent, java.awt.FontMetrics, java.lang.String, javax.swing.Icon, int, int, int, int, java.awt.Rectangle, java.awt.Rectangle, java.awt.Rectangle, int)

paintEnabledText

protected void paintEnabledText(JLabel l,
                                Graphics g,
                                String s,
                                int textX,
                                int textY)

Отображает clippedText в координатах textX, textY цветом foreground метки.

Параметры:
l - экземпляр JLabel
g - экземпляр Graphics
s - текст
textX - координата X
textY - координата Y
См. также:
paint(java.awt.Graphics, javax.swing.JComponent), paintDisabledText(javax.swing.JLabel, java.awt.Graphics, java.lang.String, int, int)

paintDisabledText

protected void paintDisabledText(JLabel l,
                                 Graphics g,
                                 String s,
                                 int textX,
                                 int textY)

Отображает clippedText в координатах textX, textY цветом background.lighter(), а затем сдвигает его вниз и вправо на один пиксель с цветом background.darker().

Параметры:
l - экземпляр JLabel
g - экземпляр Graphics
s - текст
textX - координата X
textY - координата Y
См. также:
paint(java.awt.Graphics, javax.swing.JComponent), paintEnabledText(javax.swing.JLabel, java.awt.Graphics, java.lang.String, int, int)

paint

public void paint(Graphics g,
                  JComponent c)

Отображает текст метки цветом foreground, если метка непрозрачна, то отображает весь фон цветом background. Текст метки рисуется с помощью paintEnabledText(javax.swing.JLabel, java.awt.Graphics, java.lang.String, int, int) или paintDisabledText(javax.swing.JLabel, java.awt.Graphics, java.lang.String, int, int). Позиции элементов метки вычисляются с помощью layoutCL(javax.swing.JLabel, java.awt.FontMetrics, java.lang.String, javax.swing.Icon, java.awt.Rectangle, java.awt.Rectangle, java.awt.Rectangle).

Переопределяет:
paint в классе ComponentUI
Параметры:
g - контекст рисования
c - компонент, который рисуется; этот параметр часто игнорируется, но может использоваться, если объект UI бессостоятельный и используется несколькими компонентами
См. также:
paintEnabledText(javax.swing.JLabel, java.awt.Graphics, java.lang.String, int, int), paintDisabledText(javax.swing.JLabel, java.awt.Graphics, java.lang.String, int, int), layoutCL(javax.swing.JLabel, java.awt.FontMetrics, java.lang.String, javax.swing.Icon, java.awt.Rectangle, java.awt.Rectangle, java.awt.Rectangle)

getPreferredSize

public Dimension getPreferredSize(JComponent c)

Описание скопировано из класса: ComponentUI

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

Переопределяет:
getPreferredSize в классе ComponentUI
Параметры:
c - компонент, размер которого запрошен; этот параметр часто игнорируется, но может использоваться, если объект UI бессостоятельный и используется несколькими компонентами
См. также:
JComponent.getPreferredSize(), LayoutManager.preferredLayoutSize(java.awt.Container)

getMinimumSize

public Dimension getMinimumSize(JComponent c)

Описание скопировано из класса: ComponentUI

Возвращает минимальный размер указанного компонента, соответствующий внешнему виду. Если null возвращается, минимальный размер будет вычислен менеджером компоновки компонента (это предпочтительный подход для любого компонента с установленным менеджером компоновки). По умолчанию этот метод вызывает getPreferredSize и возвращает это значение.

Переопределяет:
getMinimumSize в классе ComponentUI
Параметры:
c - компонент, минимальный размер которого запрошен; этот параметр часто игнорируется, но может использоваться, если объект UI бессостоятельный и используется несколькими компонентами
Возвращает:
getPreferredSize(c)
См. также:
JComponent.getMinimumSize(), LayoutManager.minimumLayoutSize(java.awt.Container), ComponentUI.getPreferredSize(javax.swing.JComponent)

getMaximumSize

public Dimension getMaximumSize(JComponent c)

Описание скопировано из класса: ComponentUI

Возвращает максимальный размер указанного компонента, соответствующий внешнему виду. Если null возвращается, максимальный размер будет вычислен менеджером компоновки компонента (это предпочтительный подход для любого компонента с установленным менеджером компоновки). По умолчанию этот метод вызывает getPreferredSize и возвращает это значение.

Переопределяет:
getMaximumSize в классе ComponentUI
Параметры:
c - компонент, максимальный размер которого запрошен; этот параметр часто игнорируется, но может использоваться, если объект UI бессостоятельный и используется несколькими компонентами
Возвращает:
getPreferredSize(c)
См. также:
JComponent.getMaximumSize(), LayoutManager2.maximumLayoutSize(java.awt.Container)

getBaseline

public int getBaseline(JComponent c,
                       int width,
                       int height)

Возвращает линию базовой строки.

Переопределяет:
getBaseline в классе ComponentUI
Параметры:
c - компонент, для которого запрашивается линия базовой строки
width - ширина для получения линии базовой строки
height - высота для получения линии базовой строки
Возвращает:
линию базовой строки или значение < 0, указывающее, что нет разумной линии базовой строки
Исключения:
NullPointerException - если c является null
IllegalArgumentException - если ширина или высота < 0
См. также:
JComponent.getBaseline(int, int)

getBaselineResizeBehavior

public Component.BaselineResizeBehavior getBaselineResizeBehavior(JComponent c)

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

Переопределяет:
getBaselineResizeBehavior в классе ComponentUI
Параметры:
c - компонент, для которого требуется поведение изменения размера базовой строки
Возвращает:
перечисление, указывающее, как изменяется базовая строка при изменении размера компонента
Исключения:
NullPointerException - если c является null
См. также:
JComponent.getBaseline(int, int)

installUI

public void installUI(JComponent c)

Описание скопировано из класса: ComponentUI

Конфигурирует указанный компонент в соответствии с внешним видом. Этот метод вызывается, когда экземпляр ComponentUI устанавливается в качестве делегата UI для указанного компонента. Этот метод должен полностью настроить компонент для внешнего вида, включая следующие действия:

  1. Установить значения свойств по умолчанию для цвета, шрифтов, границ, значков, непрозрачности и т. д. на компоненте. По возможности, значения свойств, инициализированные программой клиента, не должны переопределяться.
  2. Установить менеджер событий на компоненте, если необходимо.
  3. Создать/добавить необходимые подкомпоненты в компонент.
  4. Создать/установить обработчики событий на компоненте.
  5. Создать/установить прослушиватель событий изменения свойств на компоненте для соответствующей обработки изменений свойств компонента.
  6. Установить UI для клавиатуры (мнемоники, перемещение и т. д.) на компоненте.
  7. Инициализировать необходимые данные экземпляра.

Переопределяет:
installUI в классе ComponentUI
Параметры:
c - компонент, в который устанавливается этот делегат UI
См. также:
ComponentUI.uninstallUI(javax.swing.JComponent), JComponent.setUI(javax.swing.plaf.ComponentUI), JComponent.updateUI()

uninstallUI

public void uninstallUI(JComponent c)

Описание скопировано из класса: ComponentUI

Отменяет конфигурацию, которая была выполнена для указанного компонента во время installUI. Этот метод вызывается, когда этот UIComponent экземпляр удаляется в качестве делегата пользовательского интерфейса для указанного компонента. Этот метод должен отменить конфигурацию, выполненную в installUI, тщательно сохраняя экземпляр JComponent в чистовом состоянии (без лишних слушателей, объектов свойств, специфичных для внешнего вида и т. д.). Это должно включать следующее:

  1. Удаление любых установленных UI-рамками границ компонента.
  2. Удаление любых установленных UI-менеджерами компоновщиков из компонента.
  3. Удаление любых добавленных UI-подкомпонентов из компонента.
  4. Удаление любых добавленных UI-слушателей событий/свойств из компонента.
  5. Удаление любых установленных UI-клавишных обработчиков из компонента.
  6. Обнуление любых выделенных объектов данных экземпляра для возможности GC.

Overrides:
uninstallUI в классе ComponentUI
Параметры:
c - компонент, из которого удаляется этот делегат пользовательского интерфейса; этот аргумент часто игнорируется, но может использоваться, если объект пользовательского интерфейса бессостоятельный и используется несколькими компонентами
См. также:
ComponentUI.installUI(javax.swing.JComponent), JComponent.updateUI()

installDefaults

protected void installDefaults(JLabel c)

Устанавливает свойства по умолчанию.

Параметры:
c - экземпляр JLabel

installListeners

protected void installListeners(JLabel c)

Регистрирует слушателей.

Параметры:
c - экземпляр JLabel

installComponents

protected void installComponents(JLabel c)

Регистрирует компоненты.

Параметры:
c - экземпляр JLabel

installKeyboardActions

protected void installKeyboardActions(JLabel l)

Регистрирует действия с клавиатурой.

Параметры:
l - экземпляр JLabel

uninstallDefaults

protected void uninstallDefaults(JLabel c)

Удаляет свойства по умолчанию.

Параметры:
c - экземпляр JLabel

uninstallListeners

protected void uninstallListeners(JLabel c)

Удаляет слушателей.

Параметры:
c - экземпляр JLabel

uninstallComponents

protected void uninstallComponents(JLabel c)

Удаляет компоненты.

Параметры:
c - экземпляр JLabel

uninstallKeyboardActions

protected void uninstallKeyboardActions(JLabel c)

Удаляет действия с клавиатурой.

Параметры:
c - экземпляр JLabel

createUI

public static ComponentUI createUI(JComponent c)

Возвращает экземпляр BasicLabelUI.

Параметры:
c - компонент
Возвращает:
экземпляр BasicLabelUI

propertyChange

public void propertyChange(PropertyChangeEvent e)

Описание скопировано из интерфейса: PropertyChangeListener

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

Определено в:
propertyChange в интерфейсе PropertyChangeListener
Параметры:
e - объект PropertyChangeEvent, описывающий источник события и изменённое свойство.

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Spec-Zone.ru

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