# ToolTip

创建一个在屏幕任何位置上总在最前端的窗口。

ToolTip [, Text, X, Y, WhichToolTip]

#### 参数

Text | 如果留空或省略，已存在的 tooltip (如果有的话) 将被隐藏。否则，此参数是要显示在 tooltip 中的文本。要创建一个多行 tooltip ，在每行中使用换行符(`n)，例如 行1`n行2 。 如果 Text 很长，通过使用一个 continuation section(连续章节) 能将它分成许多更短的行，这会改善可读性和可维护性。
X, Y | 相对于激活的窗口的 tooltip 的 X 和 Y 坐标位置(使用 "CoordMode, ToolTip" 来改变成屏幕坐标)。如果省略坐标，tooltip 将显示在鼠标指针附近。X 和 Y 坐标可以是 expressions(表达式) 。
WhichToolTip | 如果你不需要同时显示多个 tooltips ，省略此参数。否则，在 1 到 20 之间的一个数字指示哪个 tooltip 窗口运作在上面。如果未指定，这数字是 1 (首个)。此参数可以是一个 expression 。

#### 注意

如果 X 和 Y 坐标会导致 tooltip 脱离屏幕，它会重新定位来使其整个可见。

tooltip 会显示，直到发生了下列情况之一：

- 脚本终止。
- ToolTip 命令用一个空的 Text 参数再次执行。
- 用户在 tooltip 上点击 (此特性会根据操作系统的版本而出现不同)。

一个 GUI(图形用户接口) 窗口可通过 Gui +OwnDialogs 来成为一个 tooltip 的主人。这样的一个 tooltip 会在它的主人毁灭后自动地毁灭。

#### 相关命令

CoordMode, TrayTip, GUI, Progress, SplashTextOn, MsgBox, InputBox, FileSelectFile, FileSelectFolder

#### 示例

    ToolTip, 多行`nTooltip, 100, 150

    ; 要使一个 ToolTip 不使用 Sleep(其停止当前线程) 而在某个时间段后消失：
    #Persistent
    ToolTip, 定时的 ToolTip`n它将显示 5 秒。
    SetTimer, RemoveToolTip, 5000
    return

    RemoveToolTip:
    SetTimer, RemoveToolTip, Off
    ToolTip
    return

翻译：天堂之门 menk33@163.com 2008年8月12日