Класс BasicTabbedPaneUI

public class BasicTabbedPaneUI
extends TabbedPaneUI
implements SwingConstants

Поля

tabPane

protected JTabbedPane tabPane

выделение

protected Color highlight

светлоеВыделение

protected Color lightHighlight

тень

protected Color shadow

тёмнаяТень

protected Color darkShadow

фокус

protected Color focus

отступТекстИконка

protected int textIconGap

перекрытиеСплошногоЭлементаТаба

protected int tabRunOverlay

отступыТаба

protected Insets tabInsets

отступыВыделенногоТаба

protected Insets selectedTabPadInsets

отступыОбластиТабов

protected Insets tabAreaInsets

отступыГраницыСодержимого

protected Insets contentBorderInsets

клавишаВверх

@Deprecated
protected KeyStroke upKey

Устаревший. С Java 2 платформы v1.3.

Начиная с Java 2 платформы v1.3, это ранее недокументированное поле больше не используется. Связки клавиш теперь определяются LookAndFeel, пожалуйста, обратитесь к спецификации связок клавиш для получения более подробной информации.

клавишаВниз

@Deprecated
protected KeyStroke downKey

Устаревший. С Java 2 платформы v1.3.

Начиная с Java 2 платформы v1.3, это ранее недокументированное поле больше не используется. Связки клавиш теперь определяются LookAndFeel, пожалуйста, обратитесь к спецификации связок клавиш для получения более подробной информации.

клавишаВлево

@Deprecated
protected KeyStroke leftKey

Устаревший. С Java 2 платформы v1.3.

Начиная с Java 2 платформы v1.3, это ранее недокументированное поле больше не используется. Связки клавиш теперь определяются LookAndFeel, пожалуйста, обратитесь к спецификации связок клавиш для получения более подробной информации.

клавишаВправо

@Deprecated
protected KeyStroke rightKey

Устаревший. С Java 2 платформы v1.3.

Начиная с Java 2 платформы v1.3, это ранее недокументированное поле больше не используется. Связки клавиш теперь определяются LookAndFeel, пожалуйста, обратитесь к спецификации связок клавиш для получения более подробной информации.

сплошныеЭлементыТабов

protected int[] tabRuns

количествоСплошныхЭлементов

protected int runCount

выделенныйСплошнойЭлемент

protected int selectedRun

прямоугольники

protected Rectangle[] rects

максимальнаяВысотаТаба

protected int maxTabHeight

максимальнаяШиринаТаба

protected int maxTabWidth

слушательИзмененийТабов

protected ChangeListener tabChangeListener

слушательИзмененийСвойств

protected PropertyChangeListener propertyChangeListener

слушательНажатийМыши

protected MouseListener mouseListener

слушательФокуса

protected FocusListener focusListener

прямоугольникРасчёта

protected transient Rectangle calcRect

Прямоугольник, используемый для общих расчётов макета, чтобы избежать создания большого количества новых прямоугольников на лету.

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

BasicTabbedPaneUI

public BasicTabbedPaneUI()

Методы

createUI

public static ComponentUI createUI(JComponent c)

installUI

public void installUI(JComponent c)

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

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

1. Установить значения свойств по умолчанию для цвета, шрифтов, границ, иконок, непрозрачности и т.д. на компоненте. Всякий раз, когда это возможно, значения свойств, инициализированные клиентом программы, не должны перезаписываться.
2. Установить LayoutManager на компоненте, если это необходимо.
3. Создать/добавить все необходимые подкомпоненты к компоненту.
4. Создать/установить слушатели событий на компоненте.
5. Создать/установить PropertyChangeListener на компоненте, чтобы надлежащим образом обнаруживать и реагировать на изменения свойств компонента.
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 удаляется в качестве делегата UI для указанного компонента. Этот метод должен отменить настройку, выполненную в installUI, уделяя внимание тому, чтобы оставить экземпляр JComponent в чистом состоянии (без лишних слушателей, специфичных для внешнего вида объектов свойств и т.д.). Это должно включать следующее:

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

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

uninstallUI в классе ComponentUI

Параметры:

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

См. также:

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

createLayoutManager

protected LayoutManager createLayoutManager()

Вызывается installUI для создания объекта менеджера компоновки для управления JTabbedPane

Возвращает:

объект менеджера компоновки

См. также:

BasicTabbedPaneUI.TabbedPaneLayout, JTabbedPane.getTabLayoutPolicy()

installComponents

protected void installComponents()

Создаёт и устанавливает любые необходимые подкомпоненты для JTabbedPane. Вызывается installUI.

С:

1.4

createScrollButton

protected JButton createScrollButton(int direction)

Создаёт и возвращает JButton, который позволит пользователю прокручивать вкладки в определённом направлении. Возвращаемый JButton должен быть экземпляром UIResource.

Параметры:

direction - Одно из констант SwingConstants: SOUTH, NORTH, EAST или WEST

Возвращает:

Виджет для прокрутки

Исключения:

IllegalArgumentException - если направление не равно NORTH, SOUTH, EAST или WEST

С:

1.5

См. также:

JTabbedPane.setTabPlacement(int), SwingConstants

uninstallComponents

protected void uninstallComponents()

Удаляет любые установленные подкомпоненты из JTabbedPane. Вызывается uninstallUI.

С:

1.4

installDefaults

protected void installDefaults()

uninstallDefaults

protected void uninstallDefaults()

installListeners

protected void installListeners()

uninstallListeners

protected void uninstallListeners()

createMouseListener

protected MouseListener createMouseListener()

createFocusListener

protected FocusListener createFocusListener()

createChangeListener

protected ChangeListener createChangeListener()

createPropertyChangeListener

protected PropertyChangeListener createPropertyChangeListener()

installKeyboardActions

protected void installKeyboardActions()

uninstallKeyboardActions

protected void uninstallKeyboardActions()

setRolloverTab

protected void setRolloverTab(int index)

Устанавливает вкладку, над которой находится курсор, в index. index будет -1, если курсор больше не находится над вкладкой. Проверка на то, что переданный индекс определяет корректную вкладку, не выполняется.

Параметры:

index - Индекс вкладки, над которой находится курсор.

С:

1.5

getRolloverTab

protected int getRolloverTab()

Возвращает вкладку, над которой находится курсор, или -1 если курсор больше не находится над вкладкой.

Возвращает:

вкладку, над которой находится курсор, или -1 если курсор больше не находится над вкладкой

С:

1.5

getMinimumSize

public Dimension getMinimumSize(JComponent c)

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

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

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

getMinimumSize в классе ComponentUI

Параметры:

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

Возвращает:

объект Dimension или null

См. также:

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

getMaximumSize

public Dimension getMaximumSize(JComponent c)

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

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

Overrides:

getMaximumSize в классе ComponentUI

Parameters:

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

Returns:

объект Dimension или null

See Also:

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

getBaseline

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

Возвращает линию базового выравнивания.

Overrides:

getBaseline в классе ComponentUI

Parameters:

c — JComponent компонент, для которого запрашивается базовая линия выравнивания

width — ширина для получения базовой линии выравнивания

height — высота для получения базовой линии выравнивания

Returns:

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

Throws:

NullPointerException — если c имеет значение null

IllegalArgumentException — если ширина или высота меньше 0

Since:

1.6

See Also:

JComponent.getBaseline(int, int)

getBaselineResizeBehavior

public Component.BaselineResizeBehavior getBaselineResizeBehavior(JComponent c)

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

Overrides:

getBaselineResizeBehavior в классе ComponentUI

Parameters:

c — JComponent компонент, для которого необходимо вернуть поведение изменения базовой линии

Returns:

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

Throws:

NullPointerException — если c имеет значение null

Since:

1.6

See Also:

JComponent.getBaseline(int, int)

getBaseline

protected int getBaseline(int tab)

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

Parameters:

tab — индекс вкладки, для которой запрашивается базовая линия

Returns:

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

Throws:

IndexOutOfBoundsException — если индекс находится вне допустимого диапазона (индекс < 0 || индекс >= количество вкладок)

Since:

1.6

getBaselineOffset

protected int getBaselineOffset()

Возвращает величину смещения базовой линии. Обычно это то же значение, что и getTabLabelShiftY.

Returns:

величина смещения базовой линии

Since:

1.6

paint

public void paint(Graphics g,
                  JComponent c)

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

Отрисовывает указанный компонент соответствующим образом для темы оформления. Этот метод вызывается методом ComponentUI.update при отрисовке указанного компонента. Подклассы должны переопределить этот метод и использовать указанный объект Graphics для отрисовки содержимого компонента.

Overrides:

paint в классе ComponentUI

Parameters:

g — контекст Graphics для отрисовки

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

See Also:

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

paintTabArea

protected void paintTabArea(Graphics g,
                            int tabPlacement,
                            int selectedIndex)

Отрисовывает вкладки в области вкладок. Вызывается методом paint(). Аргумент graphics должен быть действительным объектом Graphics. Размещение вкладок может быть: JTabbedPane.TOP, JTabbedPane.BOTTOM, JTabbedPane.LEFT, или JTabbedPane.RIGHT. Выбранный индекс должен быть допустимым индексом вкладки панели вкладок (от 0 до количества вкладок - 1 включительно) или -1, если в данный момент нет выбранной вкладки. Обработка недопустимых параметров не определена.

Parameters:

g — объект графики, используемый для отрисовки

tabPlacement — размещение вкладок в JTabbedPane

selectedIndex — индекс вкладки выбранного компонента

Since:

1.4

paintTab

protected void paintTab(Graphics g,
                        int tabPlacement,
                        Rectangle[] rects,
                        int tabIndex,
                        Rectangle iconRect,
                        Rectangle textRect)

layoutLabel

protected void layoutLabel(int tabPlacement,
                           FontMetrics metrics,
                           int tabIndex,
                           String title,
                           Icon icon,
                           Rectangle tabRect,
                           Rectangle iconRect,
                           Rectangle textRect,
                           boolean isSelected)

paintIcon

protected void paintIcon(Graphics g,
                         int tabPlacement,
                         int tabIndex,
                         Icon icon,
                         Rectangle iconRect,
                         boolean isSelected)

paintText

protected void paintText(Graphics g,
                         int tabPlacement,
                         Font font,
                         FontMetrics metrics,
                         int tabIndex,
                         String title,
                         Rectangle textRect,
                         boolean isSelected)

getTabLabelShiftX

protected int getTabLabelShiftX(int tabPlacement,
                                int tabIndex,
                                boolean isSelected)

getTabLabelShiftY

protected int getTabLabelShiftY(int tabPlacement,
                                int tabIndex,
                                boolean isSelected)

paintFocusIndicator

protected void paintFocusIndicator(Graphics g,
                                   int tabPlacement,
                                   Rectangle[] rects,
                                   int tabIndex,
                                   Rectangle iconRect,
                                   Rectangle textRect,
                                   boolean isSelected)

paintTabBorder

protected void paintTabBorder(Graphics g,
                              int tabPlacement,
                              int tabIndex,
                              int x,
                              int y,
                              int w,
                              int h,
                              boolean isSelected)

Эта функция отрисовывает границу вокруг каждой вкладки. Обратите внимание, что эта функция не отрисовывает фон вкладки. Это делается в другом месте.

paintTabBackground

protected void paintTabBackground(Graphics g,
                                  int tabPlacement,
                                  int tabIndex,
                                  int x,
                                  int y,
                                  int w,
                                  int h,
                                  boolean isSelected)

paintContentBorder

protected void paintContentBorder(Graphics g,
                                  int tabPlacement,
                                  int selectedIndex)

paintContentBorderTopEdge

protected void paintContentBorderTopEdge(Graphics g,
                                         int tabPlacement,
                                         int selectedIndex,
                                         int x,
                                         int y,
                                         int w,
                                         int h)

paintContentBorderLeftEdge

protected void paintContentBorderLeftEdge(Graphics g,
                                          int tabPlacement,
                                          int selectedIndex,
                                          int x,
                                          int y,
                                          int w,
                                          int h)

paintContentBorderBottomEdge

protected void paintContentBorderBottomEdge(Graphics g,
                                            int tabPlacement,
                                            int selectedIndex,
                                            int x,
                                            int y,
                                            int w,
                                            int h)

paintContentBorderRightEdge

protected void paintContentBorderRightEdge(Graphics g,
                                           int tabPlacement,
                                           int selectedIndex,
                                           int x,
                                           int y,
                                           int w,
                                           int h)

getTabBounds

public Rectangle getTabBounds(JTabbedPane pane,
                              int i)

Возвращает границы указанного индекса вкладки. Границы указаны относительно координат JTabbedPane.

Specified by:

getTabBounds в классе TabbedPaneUI

getTabRunCount

public int getTabRunCount(JTabbedPane pane)

Specified by:

getTabRunCount в классе TabbedPaneUI

tabForCoordinate

public int tabForCoordinate(JTabbedPane pane,
                            int x,
                            int y)

Возвращает индекс вкладки, пересекающей указанную точку в пространстве координат JTabbedPane.

Specified by:

tabForCoordinate в классе TabbedPaneUI

getTabBounds

protected Rectangle getTabBounds(int tabIndex,
                                 Rectangle dest)

Возвращает границы указанной вкладки в пространстве координат компонента JTabbedPane. Это необходимо, потому что прямоугольники вкладок по умолчанию определяются в пространстве координат компонента, где они отрисовываются, что может быть JTabbedPane (для WRAP_TAB_LAYOUT) или ScrollableTabPanel (SCROLL_TAB_LAYOUT). Этот метод следует использовать всякий раз, когда прямоугольник вкладки должен быть относительно самого JTabbedPane, и результат должен быть помещен в назначенный объект Rectangle (вместо создания и возврата нового Rectangle каждый раз). Параметр индекса вкладки должен быть допустимым индексом вкладки панели вкладок (от 0 до количества вкладок - 1 включительно). Параметр прямоугольника назначения должен быть допустимым экземпляром Rectangle. Обработка недопустимых параметров не определена.

Parameters:

tabIndex — индекс вкладки

dest — прямоугольник, куда должен быть помещен результат

Returns:

результирующий прямоугольник

Since:

1.4

getVisibleComponent

protected Component getVisibleComponent()

setVisibleComponent

protected void setVisibleComponent(Component component)

assureRectsCreated

protected void assureRectsCreated(int tabCount)

expandTabRunsArray

protected void expandTabRunsArray()

getRunForTab

protected int getRunForTab(int tabCount,
                           int tabIndex)

lastTabInRun

protected int lastTabInRun(int tabCount,
                           int run)

getTabRunOverlay

protected int getTabRunOverlay(int tabPlacement)

getTabRunIndent

protected int getTabRunIndent(int tabPlacement,
                              int run)

shouldPadTabRun

protected boolean shouldPadTabRun(int tabPlacement,
                                  int run)

shouldRotateTabRuns

protected boolean shouldRotateTabRuns(int tabPlacement)

getIconForTab

protected Icon getIconForTab(int tabIndex)

getTextViewForTab

protected View getTextViewForTab(int tabIndex)

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

Parameters:

tabIndex — индекс вкладки

Returns:

текстовое представление для отрисовки текста вкладки или null, если специальная отрисовка не требуется

Since:

1.4

calculateTabHeight

protected int calculateTabHeight(int tabPlacement,
                                 int tabIndex,
                                 int fontHeight)

calculateMaxTabHeight

protected int calculateMaxTabHeight(int tabPlacement)

calculateTabWidth

protected int calculateTabWidth(int tabPlacement,
                                int tabIndex,
                                FontMetrics metrics)

calculateMaxTabWidth

protected int calculateMaxTabWidth(int tabPlacement)

calculateTabAreaHeight

protected int calculateTabAreaHeight(int tabPlacement,
                                     int horizRunCount,
                                     int maxTabHeight)

calculateTabAreaWidth

protected int calculateTabAreaWidth(int tabPlacement,
                                    int vertRunCount,
                                    int maxTabWidth)

getTabInsets

protected Insets getTabInsets(int tabPlacement,
                              int tabIndex)

getSelectedTabPadInsets

protected Insets getSelectedTabPadInsets(int tabPlacement)

getTabAreaInsets

protected Insets getTabAreaInsets(int tabPlacement)

getContentBorderInsets

protected Insets getContentBorderInsets(int tabPlacement)

getFontMetrics

protected FontMetrics getFontMetrics()

navigateSelectedTab

protected void navigateSelectedTab(int direction)

selectNextTabInRun

protected void selectNextTabInRun(int current)

selectPreviousTabInRun

protected void selectPreviousTabInRun(int current)

selectNextTab

protected void selectNextTab(int current)

selectPreviousTab

protected void selectPreviousTab(int current)

selectAdjacentRunTab

protected void selectAdjacentRunTab(int tabPlacement,
                                    int tabIndex,
                                    int offset)

getFocusIndex

protected int getFocusIndex()

Возвращает индекс вкладки, которая имеет фокус.

Возвращает:

индекс вкладки, имеющей фокус

С:

1.5

getTabRunOffset

protected int getTabRunOffset(int tabPlacement,
                              int tabCount,
                              int tabIndex,
                              boolean forward)

getPreviousTabIndex

protected int getPreviousTabIndex(int base)

getNextTabIndex

protected int getNextTabIndex(int base)

getNextTabIndexInRun

protected int getNextTabIndexInRun(int tabCount,
                                   int base)

getPreviousTabIndexInRun

protected int getPreviousTabIndexInRun(int tabCount,
                                       int base)

Предыдущий набор вкладок

protected int getPreviousTabRun(int baseRun)

Следующий набор вкладок

protected int getNextTabRun(int baseRun)

rotateInsets

protected static void rotateInsets(Insets topInsets,
                                   Insets targetInsets,
                                   int targetPlacement)