TrayTip


在托盘图标处创建一个气泡消息窗口。要求 Windows 2000/XP 或以上操作系统。

TrayTip [, Title, Text, Seconds, Options]

参数

Title

如果省略所有参数,当前显示的任何气泡消息窗口将被移除。

否则,此参数是窗体的标题,最长 73 字符(超出此长度将不显示)。

如果 Title 为空,标题行将完全不显示,使窗口垂直距离缩短。

Text

如果省略此参数或留空,当前显示的任何气泡消息窗口将被移除。

否则,指定要显示的信息,会在 Title 下方显示。只显示 Text 的前 265 字符。回车符(`r)或换行符(`n)可以被用来创建多行文本。例如:行1`n行2

如果 Text 较长,可通过 continuation section(连 续章节) 分割成若干较短的行,来提高程序的可读性和可维护性。

Seconds

窗体显示的大概的秒数,之后它将被操作系统自动地移除。指定一个小于 10 或大于 30 的数字,通常会被最小值 (10) 或最大值 (30) 的显示时间代替。如果省略或留空,通常会采用最小时间。此参数可以是 expression(表达 式)。

真实的时间可能不同于指定的时间。Microsoft 解释说,“如果没有显示用户正在使用计算机,系统会不将此段时间计入。”(技术细节请看 这 里。)因此,为了精确控制托盘窗口的显示,可使用 Sleep 命令紧跟不带参数的 TrayTip,或像下方示例中使用 SetTimer

Options

指定一下数字中的一个,会在 Title 左侧显示小图标:

1: 消息图标
2: 警告图标
3: 错误图标

如果省略,默认为 0,无图标显示。此参数可以是 expression

注意

TrayTip 要求 Windows 2000/XP 或以上的操作系统。在 Windows 9x/NT 上此命令不起作用。

如果脚本没有托盘图标(通过 #NoTrayIconMenu, tray, NoIcon),那么 TrayTip 气泡窗体不能被显示。同样地,如果下列的 REG_DWORD 值已存在,并已被设为 0 ,那么 TrayTip 不会起作用:
HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced >> EnableBalloonTips

当显示一个气泡窗体时,操作系统通常会播放一个声音。可通过加上 16 到 Options 参 数来关闭此声音(例如 16 是无声音无图标,17 是无声音有信息图标,等等。)

做一个相关提示,每当用户将鼠标悬停在脚本托盘图标上时,会有提示显示。提示内容可以通过:Menu, Tray, Tip, 我的新文本 来改变。

相关命令

ToolTip, SetTimer, Menu, SplashTextOn, MsgBox, InputBox, FileSelectFile, FileSelectFolder

示例

TrayTip, My Title, Multiline`nText, 20, 17

; 为了更精确的控制显示时间
; 而不使用 Sleep (其会停止当前线程):
#Persistent
TrayTip, Timed TrayTip, 此文本将被显示 5 秒。
SetTimer, RemoveTrayTip, 5000
return
RemoveTrayTip:
SetTimer, RemoveTrayTip, Off
TrayTip
return
; 为了让 TrayTip 永久显示, 使用 timer 来周期性地进行刷新:
SetTimer, RefreshTrayTip, 1000
Gosub, RefreshTrayTip ; 调用一次来让它马上开始。
return
RefreshTrayTip:
TrayTip, Refreshed TrayTip, 这是一个更持久的 TrayTip 。, , 16
return
翻译:Xiangee   修正:天堂之门 menk33@163.com 2008年8月7日