javax.swing
類別 ToolTipManager

java.lang.Object
  java.awt.event.MouseAdapter
      javax.swing.ToolTipManager

所有已實作的介面：

MouseListener, MouseMotionListener, MouseWheelListener, EventListener

public class ToolTipManager
extends MouseAdapter
implements MouseMotionListener

管理系統中的所有 ToolTips。

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。
boolean	isLightWeightPopupEnabled() 如果使用輕量級（所有 Java）Tooltips，則返回 true；如果使用重量級（本機同位體）Tooltips，則返回 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 時，該 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()

如果使用輕量級（所有 Java）Tooltips，則返回 true；如果使用重量級（本機同位體）Tooltips，則返回 false。

返回：

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)

鼠標進入元件區域時調用。這確定是否應該顯示該工具提示。

指定者：

介面 MouseListener 中的 mouseEntered

覆寫：

類別 MouseAdapter 中的 mouseEntered

參數：

event - 相關事件

mouseExited

public void mouseExited(MouseEvent event)

鼠標退出元件區域時調用。任何顯示的工具提示都應該隱藏。

指定者：

介面 MouseListener 中的 mouseExited

覆寫：

類別 MouseAdapter 中的 mouseExited

參數：

event - 相關事件

mousePressed

public void mousePressed(MouseEvent event)

當按下鼠標時調用。任何工具提示顯示都應該隱藏。

指定者：

介面 MouseListener 中的 mousePressed

覆寫：

類別 MouseAdapter 中的 mousePressed

參數：

event - 相關事件

mouseDragged

public void mouseDragged(MouseEvent event)

按下和拖動鼠標時調用。不執行任何操作。

指定者：

介面 MouseMotionListener 中的 mouseDragged

覆寫：

類別 MouseAdapter 中的 mouseDragged

參數：

event - 相關事件

mouseMoved

public void mouseMoved(MouseEvent event)

移動鼠標時調用。確定是否應該顯示工具提示。

指定者：

介面 MouseMotionListener 中的 mouseMoved

覆寫：

類別 MouseAdapter 中的 mouseMoved

參數：

event - 相關事件