# 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 上此命令不起作用。

如果脚本没有托盘图标(通过 #NoTrayIcon 或 Menu, 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日