Класс 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`	Всплывающее окно с тяжелым весом включено.
`protected boolean`	`lightWeightPopupEnabled`	Всплывающее окно со светлым весом включено.

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

Модификатор и тип	Метод	Описание
`int`	`getDismissDelay()`	Возвращает значение задержки скрытия.
`int`	`getInitialDelay()`	Возвращает значение начальной задержки.
`int`	`getReshowDelay()`	Возвращает свойство задержки повторного отображения.
`boolean`	`isEnabled()`	Возвращает true, если этот объект включен.
`boolean`	`isLightWeightPopupEnabled()`	Возвращает true, если используются лёгкие (полностью Java) всплывающие подсказки, или false, если используются тяжёлые (нативные) всплывающие подсказки.
`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` выбирает использовать лёгкую `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, 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/ToolTipManager.html