javax.swing.plaf

Класс ComponentUI

java.lang. Объект

javax.swing.plaf. ComponentUI

Прямые Известные Подклассы:

ButtonUI, ColorChooserUI, ComboBoxUI, DesktopIconUI, DesktopPaneUI, FileChooserUI, InternalFrameUI, LabelUI, LayerUI, ListUI, MenuBarUI, OptionPaneUI, PanelUI, PopupMenuUI, ProgressBarUI, RootPaneUI, ScrollBarUI, ScrollPaneUI, SeparatorUI, SliderUI, SpinnerUI, SplitPaneUI, TabbedPaneUI, TableHeaderUI, TableUI, TextUI, ToolBarUI, ToolTipUI, TreeUI, ViewportUI

public abstract class ComponentUI
extends Object

Базовый класс для всего UI делегирует объекты в Swing сменная архитектура стили. Объект делегата UI для компонента Swing ответственен за реализацию аспектов компонента, которые зависят от стили. JComponent класс вызывает методы от этого класса, чтобы делегировать операции (рисование, вычисления расположения, и т.д.), который может измениться в зависимости от установленного стили. Клиентские программы не должны вызвать методы на этот класс непосредственно.

См. Также:

JComponent, UIManager

Сводка конструктора

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

Конструктор и Описание
ComponentUI() Единственный конструктор.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
boolean	contains(JComponent c, int x, int y) Возвраты true если указанный x, y расположение содержится в пределах определенной формы стили указанного компонента.
static ComponentUI	createUI(JComponent c) Возвращает экземпляр делегата UI к указанному компоненту.
Доступный	getAccessibleChild(JComponent c, int i) Возвраты ith Accessible дочерний элемент объекта.
int	getAccessibleChildrenCount(JComponent c) Возвращает число доступных дочерних элементов в объекте.
int	getBaseline(JComponent c, int width, int height) Возвращает базовую линию.
Компонент. BaselineResizeBehavior	getBaselineResizeBehavior(JComponent c) Возвращает перечисление, указывающее, как базовая линия он компонентные изменения как размер изменяется.
Размерность	getMaximumSize(JComponent c) Возвращает максимальный размер указанного компонента, подходящий для стили.
Размерность	getMinimumSize(JComponent c) Возвращает минимальный размер указанного компонента, подходящий для стили.
Размерность	getPreferredSize(JComponent c) Возвращает привилегированный размер указанного компонента, подходящий для стили.
void	installUI(JComponent c) Конфигурирует указанный компонент соответственно для стили.
void	paint(Graphics g, JComponent c) Красит указанный компонент соответственно для стили.
void	uninstallUI(JComponent c) Конфигурация реверсов, которая была сделана на указанном компоненте во время installUI.
void	update(Graphics g, JComponent c) Уведомляет этого делегата UI, что пора нарисовать указанный компонент.

Методы java.lang унаследованный от класса. Объект

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

Деталь конструктора

ComponentUI

public ComponentUI()

Единственный конструктор. (Для вызова конструкторами подкласса, обычно неявными.)

Деталь метода

installUI

public void installUI(JComponent c)

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

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

Параметры:

c - компонент, где этот делегат UI устанавливается

См. Также:

uninstallUI(javax.swing.JComponent), JComponent.setUI(javax.swing.plaf.ComponentUI), JComponent.updateUI()

uninstallUI

public void uninstallUI(JComponent c)

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

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

Параметры:

c - компонент, из которого удаляется этот делегат UI; этот параметр часто игнорируется, но мог бы использоваться, если объект UI не сохраняющий состояние и совместно используемым многократными компонентами

См. Также:

installUI(javax.swing.JComponent), JComponent.updateUI()

краска

public void paint(Graphics g,
         JComponent c)

Красит указанный компонент соответственно для стили. Этот метод вызывается от ComponentUI.update метод, когда указанный компонент красится. Подклассы должны переопределить этот метод и использовать указанное Graphics возразите, чтобы представить контент компонента.

Параметры:

g - Graphics контекст, в котором можно нарисовать

c - нарисованный компонент; этот параметр часто игнорируется, но мог бы использоваться, если объект UI не сохраняющий состояние и совместно используемым многократными компонентами

См. Также:

update(java.awt.Graphics, javax.swing.JComponent)

обновление

public void update(Graphics g,
          JComponent c)

Уведомляет этого делегата UI, что пора нарисовать указанный компонент. Этот метод вызывается JComponent когда указанный компонент красится.

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

Параметры:

g - Graphics контекст, в котором можно нарисовать

c - нарисованный компонент; этот параметр часто игнорируется, но мог бы использоваться, если объект UI не сохраняющий состояние и совместно используемым многократными компонентами

См. Также:

paint(java.awt.Graphics, javax.swing.JComponent), JComponent.paintComponent(java.awt.Graphics)

getPreferredSize

public Dimension getPreferredSize(JComponent c)

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

Параметры:

c - компонент, привилегированный размер которого запрашивается; этот параметр часто игнорируется, но мог бы использоваться, если объект UI не сохраняющий состояние и совместно используемым многократными компонентами

См. Также:

JComponent.getPreferredSize(), LayoutManager.preferredLayoutSize(java.awt.Container)

getMinimumSize

public Dimension getMinimumSize(JComponent c)

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

Параметры:

c - компонент, минимальный размер которого запрашивается; этот параметр часто игнорируется, но мог бы использоваться, если объект UI не сохраняющий состояние и совместно используемым многократными компонентами

Возвраты:

a Dimension объект или null

См. Также:

JComponent.getMinimumSize(), LayoutManager.minimumLayoutSize(java.awt.Container), getPreferredSize(javax.swing.JComponent)

getMaximumSize

public Dimension getMaximumSize(JComponent c)

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

Параметры:

c - компонент, максимальный размер которого запрашивается; этот параметр часто игнорируется, но мог бы использоваться, если объект UI не сохраняющий состояние и совместно используемым многократными компонентами

Возвраты:

a Dimension объект или null

См. Также:

JComponent.getMaximumSize(), LayoutManager2.maximumLayoutSize(java.awt.Container)

содержит

public boolean contains(JComponent c,
               int x,
               int y)

Возвраты true если указанный x, y расположение содержится в пределах определенной формы стили указанного компонента. x и y определяются, чтобы быть относительно системы координат указанного компонента. Хотя компонент bounds ограничивается к прямоугольнику, этот метод обеспечивает средства для того, чтобы они определили непрямоугольную форму в пределах тех границ с целью обнаружения хита.

Параметры:

c - компонент, где x, y расположение запрашивается; этот параметр часто игнорируется, но мог бы использоваться, если объект UI не сохраняющий состояние и совместно используемым многократными компонентами

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

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

См. Также:

JComponent.contains(int, int), Component.contains(int, int)

createUI

public static ComponentUI createUI(JComponent c)

Возвращает экземпляр делегата UI к указанному компоненту. Каждый подкласс должен обеспечить свои собственные помехи createUI метод, который возвращает экземпляр того подкласса делегата UI. Если подкласс делегата UI является не сохраняющим состояние, он может возвратить экземпляр, который совместно используется многократными компонентами. Если делегат UI является stateful, то он должен возвратить новый экземпляр на компонент. Реализация по умолчанию этого метода бросает ошибку, поскольку это никогда не должно вызываться.

getBaseline

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

Возвращает базовую линию. Базовая линия измеряется от вершины компонента. Этот метод прежде всего предназначается для LayoutManagers, чтобы выровнять компоненты вдоль их базовой линии. У возвращаемого значения меньше чем 0 указывают на этот компонент, нет разумной базовой линии и этого LayoutManagers не должен выровнять этот компонент на своей базовой линии.

Этот метод возвращается-1. Подклассы, у которых есть значимая базовая линия, должны переопределить соответственно.

Параметры:

c - JComponent на базовую линию требуют

width - ширина, чтобы получить базовую линию для

height - высота, чтобы получить базовую линию для

Возвраты:

базовая линия или значение <0 указаний там не являются никакой разумной базовой линией

Броски:

NullPointerException - если c null

IllegalArgumentException - если ширина или высота <0

С тех пор:

1.6

См. Также:

JComponent.getBaseline(int,int)

getBaselineResizeBehavior

public Component.BaselineResizeBehavior getBaselineResizeBehavior(JComponent c)

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

Этот метод возвраты BaselineResizeBehavior.OTHER. Подклассы, которые поддерживают базовую линию, должны переопределить соответственно.

Параметры:

c - JComponent чтобы возвратить базовую линию изменяют размеры поведения для

Возвраты:

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

Броски:

NullPointerException - если c null

С тех пор:

1.6

См. Также:

JComponent.getBaseline(int, int)

getAccessibleChildrenCount

public int getAccessibleChildrenCount(JComponent c)

Возвращает число доступных дочерних элементов в объекте. Если все дочерние элементы этой объектной реализации Accessible, этот метод должен возвратить число дочерних элементов этого объекта. UIs мог бы хотеть переопределить это, если они представляют области на экране, который может быть просмотрен как компоненты, но фактические компоненты не используются для того, чтобы представить те области. Отметьте: С v1.3 этому рекомендуют тот, разработчики вызывают Component.AccessibleAWTComponent.getAccessibleChildrenCount() вместо этого метода.

Возвраты:

число доступных дочерних элементов в объекте

См. Также:

getAccessibleChild(javax.swing.JComponent, int)

getAccessibleChild

public Accessible getAccessibleChild(JComponent c,
                            int i)

Возвраты ith Accessible дочерний элемент объекта. UIs, возможно, должен был бы переопределить это, если они представляют области на экране, который может быть просмотрен как компоненты, но фактические компоненты не используются для того, чтобы представить те области.

Отметьте: С v1.3 этому рекомендуют тот, разработчики вызывают Component.AccessibleAWTComponent.getAccessibleChild() вместо этого метода.

Параметры:

i - основанный на нуле индекс дочернего элемента

Возвраты:

ith Accessible дочерний элемент объекта

См. Также:

getAccessibleChildrenCount(javax.swing.JComponent)