Класс ToolTipManager

java.lang.Object

java.awt.event.MouseAdapter

javax.swing.ToolTipManager

Все реализованные интерфейсы:: MouseListener, MouseMotionListener, MouseWheelListener, EventListener

public final class ToolTipManager extends MouseAdapter implements MouseMotionListener

Управляет всеми всплывающими подсказками (tooltip) в системе.

ToolTipManager содержит множество свойств для настройки времени отображения всплывающих подсказок и времени их скрытия. Рассмотрим компонент, у которого всплывающая подсказка зависит от положения курсора, например, JTree. Когда курсор попадает в область JTree и над областью с действительной всплывающей подсказкой, подсказка появится через initialDelay миллисекунд. Через dismissDelay миллисекунд подсказка будет скрыта. Если курсор находится над областью с действительной всплывающей подсказкой и подсказка уже отображается, а затем курсор переместится в область без подсказки, подсказка будет скрыта. Если затем курсор вернётся в область с действительной подсказкой в течение reshowDelay миллисекунд, подсказка будет немедленно отображена, иначе подсказка будет показана снова через initialDelay миллисекунд.

С:

1.2

См. также:

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

Модификатор и тип	Класс	Описание
`protected class`	`ToolTipManager.insideTimerAction`	Внутри действия таймера.
`protected class`	`ToolTipManager.outsideTimerAction`	За пределами действия таймера.
`protected class`	`ToolTipManager.stillInsideTimerAction`	Всё ещё внутри действия таймера.

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

Модификатор и тип	Поле	Описание
`protected boolean`	`heavyWeightPopupEnabled`	Всплывающее окно тяжеловесное.
`protected boolean`	`lightWeightPopupEnabled`	Всплывающее окно лёгковесное.

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

Модификатор и тип	Метод	Описание
`int`	`getDismissDelay()`	Возвращает значение задержки скрытия.
`int`	`getInitialDelay()`	Возвращает начальное значение задержки.
`int`	`getReshowDelay()`	Возвращает свойство задержки повторного показа.
`boolean`	`isEnabled()`	Возвращает true, если объект включён, иначе false.
`boolean`	`isLightWeightPopupEnabled()`	Возвращает true, если используются лёгковесные (все-Java) `Tooltips`, или false, если используются тяжеловесные (родной peer) `Tooltips`.
`void`	`mouseDragged(MouseEvent event)`	Вызывается при нажатии и перетаскивании мыши.
`void`	`mouseEntered(MouseEvent event)`	Вызывается, когда курсор входит в область компонента.
`void`	`mouseExited(MouseEvent event)`	Вызывается, когда курсор выходит из области компонента.
`void`	`mouseMoved(MouseEvent event)`	Вызывается при перемещении мыши.
`void`	`mousePressed(MouseEvent event)`	Вызывается при нажатии кнопки мыши.
`void`	`registerComponent(JComponent component)`	Регистрирует компонент для управления всплывающими подсказками.
`void`	`setDismissDelay(int milliseconds)`	Устанавливает значение задержки скрытия.
`void`	`setEnabled(boolean flag)`	Включает или отключает всплывающую подсказку.
`void`	`setInitialDelay(int milliseconds)`	Устанавливает начальное значение задержки.
`void`	`setLightWeightPopupEnabled(boolean aFlag)`	При отображении `JToolTip`, `ToolTipManager` выбирает использование лёгковесной `JPanel` , если это подходит.
`void`	`setReshowDelay(int milliseconds)`	Используется для указания времени ожидания перед отображением подсказки `initialDelay` миллисекунд.
`static ToolTipManager`	`sharedInstance()`	Возвращает общий экземпляр `ToolTipManager`.
`void`	`unregisterComponent(JComponent component)`	Удаляет компонент из управления всплывающими подсказками.

Методы, унаследованные от класса java.awt.event.MouseAdapter

mouseClicked, mouseReleased, mouseWheelMoved

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

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

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

lightWeightPopupEnabled

protected boolean lightWeightPopupEnabled

Включен лёгкий всплывающий элемент.

heavyWeightPopupEnabled

protected boolean heavyWeightPopupEnabled

Включен тяжеловесный всплывающий элемент.

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

setEnabled

public void setEnabled(boolean flag)

Включает или отключает подсказку.

Параметры:: flag - true для включения, false для выключения

isEnabled

public boolean isEnabled()

Возвращает true, если объект включён.

Возвращает:: true, если объект включён, false в противном случае

setLightWeightPopupEnabled

public void setLightWeightPopupEnabled(boolean aFlag)

При отображении JToolTip, ToolTipManager выбирает использовать лёгкий JPanel элемент, если он подходит. Этот метод позволяет отключить эту функцию. Вам нужно отключить её, если ваше приложение смешивает лёгкие и тяжёлые компоненты.

Параметры:: aFlag - true, если требуется лёгкий элемент, false в противном случае

isLightWeightPopupEnabled

public boolean isLightWeightPopupEnabled()

Возвращает true, если используются лёгкие (чисто Java) Tooltips элементы, или false, если используются тяжёлые (нативные) Tooltips элементы.

Возвращает:: true, если используются лёгкие ToolTips элементы

setInitialDelay

public void setInitialDelay(int milliseconds)

Устанавливает значение начальной задержки.

Параметры:

milliseconds - количество миллисекунд задержки (после паузы курсора) перед отображением подсказки

См. также:

getInitialDelay

public int getInitialDelay()

Возвращает значение начальной задержки.

Возвращает:

целое число, представляющее значение начальной задержки в миллисекундах

См. также:

setDismissDelay

public void setDismissDelay(int milliseconds)

Устанавливает значение задержки скрытия.

Параметры:

milliseconds - количество миллисекунд задержки перед скрытием подсказки

См. также:

getDismissDelay

public int getDismissDelay()

Возвращает значение задержки скрытия.

Возвращает:

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

См. также:

setReshowDelay

public void setReshowDelay(int milliseconds)

Устанавливает значение задержки повторного отображения подсказки. Указывает время ожидания initialDelay миллисекунд перед повторным отображением подсказки. То есть, если подсказка скрыта, и пользователь переместит курсор в область того же компонента, содержащего корректную подсказку в течение milliseconds миллисекунд, подсказка отобразится немедленно. В противном случае, если пользователь переместит курсор в область с корректной подсказкой после milliseconds миллисекунд, пользователю придётся дождаться ещё initialDelay миллисекунд, прежде чем подсказка будет снова отображена.

Параметры:

milliseconds - время в миллисекундах

См. также:

getReshowDelay

public int getReshowDelay()

Возвращает свойство задержки повторного отображения.

Возвращает:

свойство задержки повторного отображения

См. также:

sharedInstance

public static ToolTipManager sharedInstance()

Возвращает общий ToolTipManager экземпляр.

Возвращает:: объект общего ToolTipManager

registerComponent

public void registerComponent(JComponent component)

Регистрирует компонент для управления подсказками.

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

Параметры:

component - объект JComponent для добавления

См. также:

unregisterComponent

public void unregisterComponent(JComponent component)

Удаляет компонент из управления подсказками.

Параметры:: component - объект JComponent для удаления

mouseEntered

public void mouseEntered(MouseEvent event)

Вызывается при входе курсора мыши в область компонента. Это определяет, следует ли отобразить подсказку.

Определено в:: mouseEntered в интерфейсе MouseListener
Параметры:: event - событие

mouseExited

public void mouseExited(MouseEvent event)

Вызывается при выходе курсора мыши из области компонента. Любая отображаемая подсказка должна быть скрыта.

Определено в:: mouseExited в интерфейсе MouseListener
Параметры:: event - событие

mousePressed

public void mousePressed(MouseEvent event)

Вызывается при нажатии клавиши мыши. Любая отображаемая подсказка должна быть скрыта.

Определено в:: mousePressed в интерфейсе MouseListener
Параметры:: event - событие

mouseDragged

public void mouseDragged(MouseEvent event)

Вызывается при нажатии и перетаскивании мыши. Ничего не делает.

Определено в:: mouseDragged в интерфейсе MouseMotionListener
Переопределяет:: mouseDragged в классе MouseAdapter
Параметры:: event - событие

mouseMoved

public void mouseMoved(MouseEvent event)

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

Определено в:: mouseMoved в интерфейсе MouseMotionListener
Переопределяет:: mouseMoved в классе MouseAdapter
Параметры:: event - событие

© 1993, 2023, 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://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/javax/swing/ToolTipManager.html