Класс BasicToolBarUI

javax.swing.plaf.basic.BasicToolBarUI

Все реализуемые интерфейсы:: SwingConstants

Прямые известные подклассы:: MetalToolBarUI, SynthToolBarUI

public class BasicToolBarUI extends ToolBarUI implements SwingConstants

Реализация Basic L&F для ToolBarUI. Эта реализация представляет собой «объединённое» представление/контроллер.

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

Модификатор и тип	Класс	Описание
`class`	`BasicToolBarUI.DockingListener`	Этот класс следует рассматривать как внутренний класс с модификатором «protected».
`protected class`	`BasicToolBarUI.DragWindow`	Окно, отображаемое во время перетаскивания `JToolBar`.
`protected class`	`BasicToolBarUI.FrameListener`	Класс обрабатывает события окна.
`protected class`	`BasicToolBarUI.PropertyListener`	Класс обрабатывает события изменения свойств.
`protected class`	`BasicToolBarUI.ToolBarContListener`	Класс обрабатывает события компонентов.
`protected class`	`BasicToolBarUI.ToolBarFocusListener`	Класс обрабатывает события фокуса.

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

Модификатор и тип	Поле	Описание
`protected String`	`constraintBeforeFloating`	Компоновка до перехода в плавающий режим.
`protected Color`	`dockingBorderColor`	Цвет границы области стыковки.
`protected Color`	`dockingColor`	Цвет фона границы области стыковки.
`protected MouseInputListener`	`dockingListener`	Экземпляр `MouseInputListener`.
`protected KeyStroke`	`downKey`	Устарело. Начиная с платформы Java 2 версии 1.3.
`protected BasicToolBarUI.DragWindow`	`dragWindow`	Экземпляр `DragWindow`.
`protected Color`	`floatingBorderColor`	Цвет границы области, не предназначенной для стыковки.
`protected Color`	`floatingColor`	Цвет фона границы области, не предназначенной для стыковки.
`protected int`	`focusedCompIndex`	Индекс компонента, имеющего фокус.
`protected KeyStroke`	`leftKey`	Устарело. Начиная с платформы Java 2 версии 1.3.
`protected PropertyChangeListener`	`propertyListener`	Экземпляр `PropertyChangeListener`.
`protected KeyStroke`	`rightKey`	Устарело. Начиная с платформы Java 2 версии 1.3.
`protected JToolBar`	`toolBar`	Экземпляр `JToolBar`.
`protected ContainerListener`	`toolBarContListener`	Экземпляр `ContainerListener`.
`protected FocusListener`	`toolBarFocusListener`	Экземпляр `FocusListener`.
`protected KeyStroke`	`upKey`	Устарело. Начиная с платформы Java 2 версии 1.3.

Поля, объявленные в интерфейсе SwingConstants

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

Модификатор и тип	Поле	Описание
`static final int`	`BOTTOM`	Константа ориентации контейнера, указывающая его нижнюю сторону.
`static final int`	`CENTER`	Центральное положение в области.
`static final int`	`EAST`	Направление по сторонам света — восток (вправо).
`static final int`	`HORIZONTAL`	Горизонтальная ориентация.
`static final int`	`LEADING`	Обозначает начальный край текста для языков с направлением письма слева направо и справа налево.
`static final int`	`LEFT`	Константа ориентации контейнера, указывающая его левую сторону.
`static final int`	`NEXT`	Обозначает следующее направление в последовательности.
`static final int`	`NORTH`	Направление по сторонам света — север (вверх).
`static final int`	`NORTH_EAST`	Направление по сторонам света — северо-восток (вверх и вправо).
`static final int`	`NORTH_WEST`	Направление по сторонам света — северо-запад (вверх и влево).
`static final int`	`PREVIOUS`	Обозначает предыдущее направление в последовательности.
`static final int`	`RIGHT`	Константа ориентации контейнера, указывающая его правую сторону.
`static final int`	`SOUTH`	Направление по сторонам света — юг (вниз).
`static final int`	`SOUTH_EAST`	Направление по сторонам света — юго-восток (вниз и вправо).
`static final int`	`SOUTH_WEST`	Направление по сторонам света — юго-запад (вниз и влево).
`static final int`	`TOP`	Константа ориентации контейнера, указывающая его верхнюю сторону.
`static final int`	`TRAILING`	Обозначает конечный край текста для языков с направлением письма слева направо и справа налево.
`static final int`	`VERTICAL`	Вертикальная ориентация.
`static final int`	`WEST`	Направление по сторонам света — запад (влево).

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

Конструктор	Описание
`BasicToolBarUI()`	Создаёт `BasicToolBarUI`.

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

Модификатор и тип	Метод	Описание
`boolean`	`canDock(Component c, Point p)`	Возвращает `true`, если `JToolBar` можно состыковать в указанном положении.
`protected MouseInputListener`	`createDockingListener()`	Возвращает экземпляр `MouseInputListener`.
`protected BasicToolBarUI.DragWindow`	`createDragWindow(JToolBar toolbar)`	Возвращает экземпляр `DragWindow`.
`protected JFrame`	`createFloatingFrame(JToolBar toolbar)`	Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии. Рекомендуется использовать `createFloatingWindow(JToolBar)`
`protected RootPaneContainer`	`createFloatingWindow(JToolBar toolbar)`	Создаёт окно, содержащее панель инструментов после её перетаскивания из контейнера
`protected WindowListener`	`createFrameListener()`	Создаёт новый экземпляр `WindowListener`.
`protected Border`	`createNonRolloverBorder()`	Создаёт границу без эффекта rollover для компонентов панели инструментов.
`protected PropertyChangeListener`	`createPropertyListener()`	Возвращает экземпляр `PropertyChangeListener`.
`protected Border`	`createRolloverBorder()`	Создаёт границу с эффектом rollover для компонентов панели инструментов.
`protected ContainerListener`	`createToolBarContListener()`	Возвращает экземпляр `ContainerListener`.
`protected FocusListener`	`createToolBarFocusListener()`	Возвращает экземпляр `FocusListener`.
`static ComponentUI`	`createUI(JComponent c)`	Создаёт новый экземпляр `BasicToolBarUI`.
`protected void`	`dragTo(Point position, Point origin)`	Метод используется для перетаскивания `DragWindow` во время перетаскивания `JToolBar`.
`protected void`	`floatAt(Point position, Point origin)`	Метод вызывается по окончании перетаскивания, чтобы разместить рамку на исходном месте или в плавающей рамке.
`Color`	`getDockingColor()`	Возвращает цвет, отображаемый при наведении на область стыковки
`Color`	`getFloatingColor()`	Возвращает цвет, отображаемый при наведении на плавающую область
`protected Border`	`getNonRolloverBorder(AbstractButton b)`	Возвращает границу кнопки без эффекта rollover.
`protected Border`	`getRolloverBorder(AbstractButton b)`	Возвращает границу кнопки с эффектом rollover.
`protected void`	`installComponents()`	Регистрирует компоненты.
`protected void`	`installDefaults()`	Устанавливает свойства по умолчанию.
`protected void`	`installKeyboardActions()`	Регистрирует действия клавиатуры.
`protected void`	`installListeners()`	Регистрирует слушатели.
`protected void`	`installNonRolloverBorders(JComponent c)`	Устанавливает границы без эффекта rollover для всех дочерних компонентов JComponent.
`protected void`	`installNormalBorders(JComponent c)`	Устанавливает обычные границы для всех дочерних компонентов JComponent.
`protected void`	`installRolloverBorders(JComponent c)`	Устанавливает границы с эффектом rollover для всех дочерних компонентов JComponent.
`boolean`	`isFloating()`	Возвращает `true`, если `JToolBar` находится в плавающем режиме
`boolean`	`isRolloverBorders()`	Возвращает флаг, определяющий, включены ли границы кнопок с эффектом rollover.
`protected void`	`navigateFocusedComp(int direction)`	Перемещает фокус между компонентами.
`protected void`	`paintDragWindow(Graphics g)`	Отрисовывает содержимое окна, используемого для перетаскивания.
`protected void`	`setBorderToNonRollover(Component c)`	Устанавливает для компонента границу без эффекта rollover, созданную методом `createNonRolloverBorder()`.
`protected void`	`setBorderToNormal(Component c)`	Устанавливает для компонента обычную границу.
`protected void`	`setBorderToRollover(Component c)`	Устанавливает для компонента границу с эффектом rollover, созданную методом `createRolloverBorder()`.
`void`	`setDockingColor(Color c)`	Устанавливает цвет, отображаемый при наведении на область стыковки
`void`	`setFloating(boolean b, Point p)`	Устанавливает свойство плавающего режима.
`void`	`setFloatingColor(Color c)`	Устанавливает цвет, отображаемый при наведении на плавающую область
`void`	`setFloatingLocation(int x, int y)`	Устанавливает положение в плавающем режиме.
`void`	`setOrientation(int orientation)`	Устанавливает ориентацию панели инструментов.
`void`	`setRolloverBorders(boolean rollover)`	Устанавливает флаг включения границ с эффектом rollover на панели инструментов, а также устанавливает соответствующую границу в зависимости от значения флага.
`protected void`	`uninstallComponents()`	Отменяет регистрацию компонентов.
`protected void`	`uninstallDefaults()`	Удаляет свойства по умолчанию.
`protected void`	`uninstallKeyboardActions()`	Отменяет регистрацию действий клавиатуры.
`protected void`	`uninstallListeners()`	Отменяет регистрацию слушателей.

Методы, объявленные в классе ComponentUI

contains, getAccessibleChild, getAccessibleChildrenCount, getBaseline, getBaselineResizeBehavior, getMaximumSize, getMinimumSize, getPreferredSize, installUI, paint, uninstallUI, update

Модификатор и тип	Метод	Описание
`boolean`	`contains(JComponent c, int x, int y)`	Возвращает `true`, если указанная позиция x,y находится внутри фигуры указанного компонента, определённой оформлением.
`Accessible`	`getAccessibleChild(JComponent c, int i)`	Возвращает `i`-го дочернего `Accessible` объекта.
`int`	`getAccessibleChildrenCount(JComponent c)`	Возвращает количество доступных дочерних элементов объекта.
`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)`	Возвращает предпочтительный размер указанного компонента, подходящий для данного оформления.
`void`	`installUI(JComponent c)`	Настраивает указанный компонент в соответствии с оформлением.
`void`	`paint(Graphics g, JComponent c)`	Отрисовывает указанный компонент в соответствии с оформлением.
`void`	`uninstallUI(JComponent c)`	Отменяет настройку указанного компонента, выполненную во время `installUI`.
`void`	`update(Graphics g, JComponent c)`	Уведомляет этот делегат пользовательского интерфейса о необходимости отрисовать указанный компонент.

Методы, объявленные в классе Object

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект другому объекту.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии. Финализация устарела и может быть удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Приостанавливает текущий поток до его пробуждения, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Приостанавливает текущий поток до его пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Приостанавливает текущий поток до его пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного промежутка реального времени.

Подробное описание полей

dragWindow

protected BasicToolBarUI.DragWindow dragWindow

Экземпляр DragWindow.

focusedCompIndex

protected int focusedCompIndex

Индекс компонента, находящегося в фокусе.

dockingColor

protected Color dockingColor

Цвет фона границы области закрепления.

floatingColor

protected Color floatingColor

Цвет фона границы области, не предназначенной для закрепления.

dockingBorderColor

protected Color dockingBorderColor

Цвет границы области закрепления.

floatingBorderColor

protected Color floatingBorderColor

Цвет границы области, не предназначенной для закрепления.

dockingListener

protected MouseInputListener dockingListener

Экземпляр MouseInputListener.

propertyListener

protected PropertyChangeListener propertyListener

Экземпляр PropertyChangeListener.

toolBarContListener

protected ContainerListener toolBarContListener

Экземпляр ContainerListener.

toolBarFocusListener

protected FocusListener toolBarFocusListener

Экземпляр FocusListener.

constraintBeforeFloating

protected String constraintBeforeFloating

Расположение до перехода в плавающее состояние.

upKey

@Deprecated protected KeyStroke upKey

Устарело.

Начиная с платформы Java 2 v1.3.

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

downKey

@Deprecated protected KeyStroke downKey

Устарело.

Начиная с платформы Java 2 v1.3.

leftKey

@Deprecated protected KeyStroke leftKey

Устарело.

Начиная с платформы Java 2 v1.3.

rightKey

@Deprecated protected KeyStroke rightKey

Устарело.

Начиная с платформы Java 2 v1.3.

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

BasicToolBarUI

public BasicToolBarUI()

Создает экземпляр BasicToolBarUI.

Подробное описание методов

createUI

public static ComponentUI createUI(JComponent c)

Создает новый экземпляр BasicToolBarUI.

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

installDefaults

protected void installDefaults()

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

uninstallDefaults

protected void uninstallDefaults()

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

installComponents

protected void installComponents()

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

uninstallComponents

protected void uninstallComponents()

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

installListeners

protected void installListeners()

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

uninstallListeners

protected void uninstallListeners()

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

installKeyboardActions

protected void installKeyboardActions()

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

uninstallKeyboardActions

protected void uninstallKeyboardActions()

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

navigateFocusedComp

protected void navigateFocusedComp(int direction)

Перемещает фокус между компонентами.

Параметры:: direction — направление

createRolloverBorder

protected Border createRolloverBorder()

Создает границу с эффектом наведения для компонентов панели инструментов. Эта граница устанавливается, если границы с эффектом наведения включены.

Переопределите этот метод, чтобы предоставить альтернативную границу с эффектом наведения.

Возвращает:: границу с эффектом наведения для компонентов панели инструментов
Начиная с:: 1.4

createNonRolloverBorder

protected Border createNonRolloverBorder()

Создает границу без эффекта наведения для компонентов панели инструментов. Эта граница устанавливается для компонентов, добавленных на панель инструментов, если границы с эффектом наведения не включены.

Переопределите этот метод, чтобы предоставить альтернативную границу с эффектом наведения.

Возвращает:: границу без эффекта наведения для компонентов панели инструментов
Начиная с:: 1.4

createFloatingFrame

@Deprecated(since="17", forRemoval=true) protected JFrame createFloatingFrame(JToolBar toolbar)

Устарело, планируется удаление: этот элемент API может быть удален в будущей версии.

Рекомендуется вместо него использовать createFloatingWindow(JToolBar)

Больше не используется; используйте BasicToolBarUI.createFloatingWindow(JToolBar)

Параметры:

toolbar — экземпляр JToolBar

Возвращает:

экземпляр JFrame

См. также:

createFloatingWindow

protected RootPaneContainer createFloatingWindow(JToolBar toolbar)

Создает окно, в котором отображается панель инструментов после ее перетаскивания из контейнера

Параметры:: toolbar — экземпляр JToolBar
Возвращает:: объект RootPaneContainer, содержащий панель инструментов
Начиная с:: 1.4

createDragWindow

protected BasicToolBarUI.DragWindow createDragWindow(JToolBar toolbar)

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

Параметры:: toolbar — экземпляр JToolBar
Возвращает:: экземпляр DragWindow

isRolloverBorders

public boolean isRolloverBorders()

Возвращает флаг, определяющий, включены ли границы кнопок с эффектом наведения.

Возвращает:

true, если границы с эффектом наведения включены; в противном случае false

Начиная с:

1.4

См. также:

setRolloverBorders

public void setRolloverBorders(boolean rollover)

Устанавливает флаг включения границ с эффектом наведения на панели инструментов, а также устанавливает соответствующую границу в зависимости от значения флага.

Параметры:

rollover — если true, устанавливаются границы с эффектом наведения. В противном случае устанавливаются границы без эффекта наведения

Начиная с:

1.4

См. также:

installRolloverBorders

protected void installRolloverBorders(JComponent c)

Устанавливает границы с эффектом наведения для всех дочерних компонентов JComponent.

Этот вспомогательный метод вызывает setBorderToRollover для каждого дочернего компонента.

Параметры:

c — контейнер, содержащий дочерние компоненты (обычно JToolBar)

Начиная с:

1.4

См. также:

installNonRolloverBorders

protected void installNonRolloverBorders(JComponent c)

Устанавливает границы без эффекта наведения для всех дочерних компонентов JComponent. Граница без эффекта наведения устанавливается для дочернего компонента, пока он находится на панели инструментов.

Этот вспомогательный метод вызывает setBorderToNonRollover для каждого дочернего компонента.

Параметры:

c — контейнер, содержащий дочерние компоненты (обычно JToolBar)

Начиная с:

1.4

См. также:

installNormalBorders

protected void installNormalBorders(JComponent c)

Устанавливает обычные границы для всех дочерних компонентов JComponent. Обычная граница — это исходная граница, установленная для дочернего компонента до его добавления на панель инструментов.

Этот вспомогательный метод вызывает setBorderNormal для каждого дочернего компонента.

Параметры:

c — контейнер, содержащий дочерние компоненты (обычно JToolBar)

Начиная с:

1.4

См. также:

setBorderToRollover

protected void setBorderToRollover(Component c)

Устанавливает для компонента границу с эффектом наведения, созданную методом createRolloverBorder().

Параметры:

c — компонент, для которого будет установлена граница с эффектом наведения

Начиная с:

1.4

См. также:

getRolloverBorder

protected Border getRolloverBorder(AbstractButton b)

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

Параметры:

b — кнопка, для которой вычисляется граница с эффектом наведения

Возвращает:

границу с эффектом наведения

Начиная с:

1.6

См. также:

setBorderToNonRollover

protected void setBorderToNonRollover(Component c)

Устанавливает для компонента границу без эффекта наведения, созданную методом createNonRolloverBorder().

Параметры:

c — компонент, для которого будет установлена граница без эффекта наведения

Начиная с:

1.4

См. также:

getNonRolloverBorder

protected Border getNonRolloverBorder(AbstractButton b)

Возвращает границу без эффекта наведения для кнопки.

Параметры:

b — кнопка, для которой вычисляется граница без эффекта наведения

Возвращает:

границу без эффекта наведения

Начиная с:

1.6

См. также:

setBorderToNormal

protected void setBorderToNormal(Component c)

Устанавливает для компонента обычную границу. Обычная граница — это исходная граница, установленная для дочернего компонента до его добавления на панель инструментов.

Параметры:

c — компонент, для которого будет восстановлена обычная граница

Начиная с:

1.4

См. также:

setFloatingLocation

public void setFloatingLocation(int x, int y)

Задает расположение плавающего окна.

Параметры:: x — координата X; y — координата Y

isFloating

public boolean isFloating()

Возвращает true, если JToolBar находится в плавающем состоянии

Возвращает:: true, если JToolBar находится в плавающем состоянии

setFloating

public void setFloating(boolean b, Point p)

Задает свойство плавающего состояния.

Параметры:: b — true, если JToolBar находится в плавающем состоянии; p — положение

setOrientation

public void setOrientation(int orientation)

Задает ориентацию панели инструментов.

Параметры:: orientation — новая ориентация

getDockingColor

public Color getDockingColor()

Возвращает цвет, отображаемый при наведении на область закрепления

Возвращает:: цвет, отображаемый при наведении на область закрепления

setDockingColor

public void setDockingColor(Color c)

Задает цвет, отображаемый при наведении на область закрепления

Параметры:: c — новый цвет

getFloatingColor

public Color getFloatingColor()

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

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

setFloatingColor

public void setFloatingColor(Color c)

Задает цвет, отображаемый при наведении на область плавающего окна

Параметры:: c — новый цвет

canDock

public boolean canDock(Component c, Point p)

Возвращает true, если JToolBar можно закрепить в указанном положении.

Параметры:: c — компонент; p — положение
Возвращает:: true, если JToolBar можно закрепить в указанном положении

dragTo

protected void dragTo(Point position, Point origin)

Метод используется для перетаскивания DragWindow во время перетаскивания JToolBar.

Параметры:: position — положение относительно JTollBar; origin — положение JToolBar на экране до перетаскивания

floatAt

protected void floatAt(Point position, Point origin)

Метод вызывается по завершении перетаскивания, чтобы поместить окно на исходное место или в плавающее окно.

Параметры:: position — положение относительно JTollBar; origin — положение JToolBar на экране до перетаскивания

createToolBarContListener

protected ContainerListener createToolBarContListener()

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

Возвращает:: экземпляр ContainerListener

createToolBarFocusListener

protected FocusListener createToolBarFocusListener()

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

Возвращает:: экземпляр FocusListener

createPropertyListener

protected PropertyChangeListener createPropertyListener()

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

Возвращает:: экземпляр PropertyChangeListener

createDockingListener

protected MouseInputListener createDockingListener()

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

Возвращает:: экземпляр MouseInputListener

createFrameListener

protected WindowListener createFrameListener()

Создает новый экземпляр WindowListener.

Возвращает:: новый экземпляр WindowListener

paintDragWindow

protected void paintDragWindow(Graphics g)

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

Параметры:: g — объект Graphics для отрисовки.
Выбрасывает:: NullPointerException — если g имеет значение null
Начиная с:: 1.5

© 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.