Класс ToolTipManager
- java.lang.Object
-
- java.awt.event.MouseAdapter
-
- javax.swing.ToolTipManager
- Все реализованные интерфейсы:
-
MouseListener,MouseMotionListener,MouseWheelListener,EventListener
public class ToolTipManager extends MouseAdapter implements MouseMotionListener
Управляет всеми всплывающими подсказками в системе.
Класс ToolTipManager содержит множество свойств для настройки времени отображения и скрытия всплывающих подсказок. Рассмотрим компонент, имеющий различную подсказку в зависимости от положения курсора, например, JTree. При перемещении курсора в JTree и над областью с допустимой подсказкой, подсказка отобразится через initialDelay миллисекунд. После dismissDelay миллисекунд подсказка будет скрыта. Если курсор находится над областью с допустимой подсказкой и подсказка уже отображается, а затем курсор перемещается в область без допустимой подсказки, подсказка будет скрыта. Если курсор затем вернётся в область с допустимой подсказкой в течение reshowDelay миллисекунд, подсказка будет немедленно показана; в противном случае подсказка будет показана вновь через initialDelay миллисекунд.
- С момента:
- 1.2
- См. также:
JComponent.createToolTip()
Вложенные классы
| Модификатор и тип | Класс | Описание |
|---|---|---|
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) всплывающие подсказки, или 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) | При отображении всплывающей подсказки, |
void | setReshowDelay(int milliseconds) | Используется для указания времени ожидания пользователя |
static ToolTipManager | sharedInstance() | Возвращает общий экземпляр |
void | unregisterComponent(JComponent component) | Удаляет компонент из управления всплывающими подсказками. |
Методы, объявленные в классе java.awt.event.MouseAdapter
mouseWheelMoved Методы, объявленные в классе java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait Методы, объявленные в интерфейсе java.awt.event.MouseListener
mouseClicked, mouseReleased Поля
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()
getInitialDelay
public int getInitialDelay()
Возвращает значение начальной задержки.
- Возвращает:
- целое число, представляющее начальное значение задержки в миллисекундах
- См. также:
setInitialDelay(int)
setDismissDelay
public void setDismissDelay(int milliseconds)
Устанавливает значение задержки скрытия.
- Параметры:
-
milliseconds- количество миллисекунд задержки перед скрытием подсказки - См. также:
getDismissDelay()
getDismissDelay
public int getDismissDelay()
Возвращает значение задержки скрытия.
- Возвращает:
- целое число, представляющее значение задержки скрытия в миллисекундах
- См. также:
setDismissDelay(int)
setReshowDelay
public void setReshowDelay(int milliseconds)
Устанавливает значение задержки повторного отображения. Указывает время, в течение которого пользователь должен подождать initialDelay миллисекунд, прежде чем подсказка будет отображена. То есть, если подсказка скрыта, а пользователь переходит в область того же компонента, имеющего допустимую подсказку в течение milliseconds миллисекунд, подсказка будет показана сразу. В противном случае, если пользователь переходит в область с допустимой подсказкой после milliseconds миллисекунд, пользователю потребуется подождать дополнительных initialDelay миллисекунд, прежде чем подсказка будет отображена снова.
- Параметры:
-
milliseconds- время в миллисекундах - См. также:
getReshowDelay()
getReshowDelay
public int getReshowDelay()
Возвращает свойство задержки повторного отображения.
- Возвращает:
- свойство задержки повторного отображения
- См. также:
setReshowDelay(int)
sharedInstance
public static ToolTipManager sharedInstance()
Возвращает общий ToolTipManager экземпляр.
- Возвращает:
- объект общего
ToolTipManager
registerComponent
public void registerComponent(JComponent component)
Регистрирует компонент для управления подсказками.
Это зарегистрирует сочетания клавиш для отображения и скрытия текста подсказки только в том случае, если у component есть сочетания клавиш для фокуса. Это делается для того, чтобы компоненты, которые обычно не могут быть переключены на фокус, такие как JLabel, не делались переключаемыми на фокус в результате вызова этого метода.
- Параметры:
-
component- объектJComponentдля добавления - См. также:
Component.isFocusTraversable()
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, 2020, 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/11/docs/api/java.desktop/javax/swing/ToolTipManager.html