Класс ToolTipManager

java.lang.Object

java.awt.event.MouseAdapter

javax.swing.ToolTipManager

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

public final class ToolTipManager extends MouseAdapter implements MouseMotionListener

Управляет всеми ToolTips в системе.

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

Начиная с версии:

1.2

См. также:

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

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

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

Модификатор и тип	Поле	Описание
`protected boolean`	`heavyWeightPopupEnabled`	Всплывающее окно на основе heavyweight-компонента включено.
`protected boolean`	`lightWeightPopupEnabled`	Всплывающее окно на основе lightweight-компонента включено.

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

Модификатор и тип	Метод	Описание
`int`	`getDismissDelay()`	Возвращает значение задержки перед скрытием.
`int`	`getInitialDelay()`	Возвращает значение начальной задержки.
`int`	`getReshowDelay()`	Возвращает свойство задержки перед повторным показом.
`boolean`	`isEnabled()`	Возвращает true, если этот объект включен.
`boolean`	`isLightWeightPopupEnabled()`	Возвращает true, если используются `Tooltips` на основе lightweight-компонентов (только Java), или false, если используются `Tooltips` на основе heavyweight-компонентов (с нативным peer-объектом).
`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` выбирает lightweight-вариант `JPanel`, если он помещается.
`void`	`setReshowDelay(int milliseconds)`	Используется для задания времени ожидания пользователем: прежде чем отобразится всплывающая подсказка, должно пройти `initialDelay` миллисекунд.
`static ToolTipManager`	`sharedInstance()`	Возвращает общий экземпляр `ToolTipManager`.
`void`	`unregisterComponent(JComponent component)`	Удаляет компонент из управления всплывающими подсказками.

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

mouseClicked, mouseReleased, mouseWheelMoved

Модификатор и тип	Метод	Описание
`void`	`mouseClicked(MouseEvent e)`	Вызывается, когда на компоненте щелкают кнопкой мыши (нажимают и отпускают ее).
`void`	`mouseReleased(MouseEvent e)`	Вызывается, когда на компоненте отпускают кнопку мыши.
`void`	`mouseWheelMoved(MouseWheelEvent e)`	Вызывается при прокрутке колесика мыши.

Методы, объявленные в классе 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()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения заданного времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения заданного времени.

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

lightWeightPopupEnabled

protected boolean lightWeightPopupEnabled

Всплывающее окно на основе lightweight-компонента включено.

heavyWeightPopupEnabled

protected boolean heavyWeightPopupEnabled

Всплывающее окно на основе heavyweight-компонента включено.

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

setEnabled

public void setEnabled(boolean flag)

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

Параметры:: flag — true, чтобы включить подсказку, иначе false

isEnabled

public boolean isEnabled()

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

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

setLightWeightPopupEnabled

public void setLightWeightPopupEnabled(boolean aFlag)

При отображении JToolTip ToolTipManager выбирает lightweight-вариант JPanel, если он помещается. Этот метод позволяет отключить эту функцию. Ее необходимо отключить, если приложение одновременно использует компоненты с lightweight- и heavyweight-окнами.

Параметры:: aFlag — true, если требуется lightweight-панель, иначе false

isLightWeightPopupEnabled

public boolean isLightWeightPopupEnabled()

Возвращает true, если используются Tooltips на основе lightweight-компонентов (только Java), или false, если используются Tooltips на основе heavyweight-компонентов (с нативным peer-объектом).

Возвращает:: true, если используются lightweight-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, 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.