ToolTip

在屏幕的任意位置显示一个置顶的窗口.

ToolTip Text, X, Y, WhichToolTip

参数

Text

类型: 字符串

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

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

X, Y

类型: 整数

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

WhichToolTip

类型: 整数

如果省略, 默认为 1(第一个工具提示). 否则, 请指定一个介于 1 和 20 之间的数字, 在同时使用了多个工具提示时, 用来表示要操作的工具提示窗口.

返回值

类型: 整数

如果一个工具提示正在显示或更新, 这个函数返回工具提示窗口的唯一 ID(HWND), 它可以用来移动工具提示或发送工具提示控制消息.

如果 Text 为空或省略, 返回值为零.

备注

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

如果 X 和 Y 坐标让工具提示离开屏幕, 或在 Windows 8 或更高版本的显示器工作区域之外, 则会对其进行重新定位以使其完全可见.

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

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