Класс 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 миллисекунд.
- См. также:
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) |
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
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()
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 - Переопределяет:
-
mouseEnteredв классеMouseAdapter - Параметры:
-
event- событие
mouseExited
public void mouseExited(MouseEvent event)
Вызывается при выходе мыши из области компонента. Любая отображаемая подсказка должна быть скрыта.
- Определено в:
-
mouseExitedв интерфейсеMouseListener - Переопределяет:
-
mouseExitedв классеMouseAdapter - Параметры:
-
event- событие
mousePressed
public void mousePressed(MouseEvent event)
Вызывается при нажатии мыши. Любая отображаемая подсказка должна быть скрыта.
- Определено в:
-
mousePressedв интерфейсеMouseListener - Переопределяет:
-
mousePressedв классеMouseAdapter - Параметры:
-
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.