# ToolTip

在屏幕的任意位置创建置顶的窗口.

    ToolTip Text, X, Y, WhichToolTip

## 参数

Text

  类型: 字符串

  如果为空或省略, 则隐藏现有的工具提示(如果有). 否则, 此参数为要在工具提示中显示的文本. 要创建多行的工具提示, 请在每行之间使用换行符(`n), 例如 Line1`nLine2.

  如果 Text 较长, 可以通过延续片段的方法将其分解成较短的几行, 这样可以增加可读性和可维护性.

X, Y

  类型: 整数

  相对于活动窗口的 X 和 Y 坐标(请使用 `CoordMode "ToolTip"` 来让坐标相对于屏幕). 如果省略坐标, 则工具提示显示在鼠标光标附近.

WhichToolTip

  类型: 整数

  如果您不需要同时显示多个工具提示, 请省略此参数. 否则, 请指定一个介于 1 和 20 之间的数字来表示要操作的工具提示窗口. 如果未指定, 则此数字为 1(首个).

## 备注

工具提示通常看起来像这样:

如果 X & Y 坐标会让工具提示离开屏幕, 则会对其进行重新定位以使其完全可见.

工具提示会一直显示, 直到出现以下情况之一:

- 脚本终止.
- 再次执行 ToolTip 函数, 并且 Text 参数为空.
- 用户点击了工具提示(此行为可能因操作系统版本而有所不同).

GUI 窗口可以通过 OwnDialogs 选项成为工具提示的所有者. 这样的工具提示在其拥有者被销毁时也会自动被销毁.

## 相关

CoordMode, TrayTip, GUI, MsgBox, InputBox, FileSelect, DirSelect

## 示例

在活动窗口的特定位置显示一个多行工具提示.

    ToolTip "Multiline`nTooltip", 100, 150

在一段时间后隐藏工具提示, 而不使用 Sleep(它会停止当前线程).

    ToolTip "Timed ToolTip`nThis will be displayed for 5 seconds."
    SetTimer () => ToolTip(), -5000

dftg