트레이 아이콘 근처에 풍선 메시지 창을 생성합니다.
TrayTip [, Title, Text, Seconds, Options]
매개변수를 모두 생략하면, 현재 보여지는 TrayTip 창이 제거됩니다.
그렇지 않으면, 이 매개변수는 창의 제목으로서, 73 문자까지 허용됩니다 (이 길이를 넘어간 문자는 보이지 않습니다).
Title이 비어 있으면, 제목 줄은 완전히 풍선 창으로부터 제거되고, 그 때문에 수직으로 더 짧게 됩니다.
이 매개변수를 생략하거나 비어 있으면, 현재 보여지는 TrayTip 창이 제거됩니다.
그렇지 않으면, 보여줄 메시지를 지정하십시오. Title 아래에 나타납니다. Text의 앞쪽 265 개의 문자만 보입니다. 캐리지 리턴 (`r) 또는 라인피드 (`n)를 사용하면 여러 줄의 텍스트를 만들 수 있습니다. 예를 들어: Line1`nLine2.
Text가 길면, 계속 섹션을 수단으로 더 짧은 줄로 가를 수 있습니다. 그러면 가독성과 유지관성이 더욱 향상될 것입니다.
창을 보여줄 대략적인 초의 개수. 그 이후는 자동으로 OS가 제거합니다. 10보다 작거나 30보다 크면 대신에 보통 최소 시간 (10) 또는 최대 시간 (30)을 보여주는 시간으로 사용됩니다. 비어 있거나 생략하면, 최소 시간이 보통 사용됩니다. 이 매개변수는 표현식일 수 있습니다.
실제 시간제한은 지정한 시간과 다를 수 있습니다. 마이크로소프트사의 설명에 의하면, "사용자가 컴퓨터를 사용하고 있는 듯 보이면, 시스템은 시간제한을 향하여 이 시간을 세지 않습니다." (기술적인 상세는 여기를 참조하십시오). 그러므로, 얼마나 오랫동안 TrayTip을 보여줄 지 정밀하게 제어하려면, Sleep 명령어 다음에 매개변수 없이 TrayTip을 사용하거나, 아니면 아래의 예제 섹션에서 시연하듯이 SetTimer를 사용하십시오.
Options 매개변수는 다음 값들의 조합(합)일 수 있습니다:
| 기능 | 십진 값 | 십육진 값 |
|---|---|---|
| 정보(Info) 아이콘 | 1 | 0x1 |
| 경고(Warning) 아이콘 | 2 | 0x2 |
| 에러(Error) 아이콘 | 3 | 0x3 |
| Windows XP 이후: 고지 사운드를 연주하지 않습니다. | 16 | 0x10 |
| Windows Vista 이후: 큰 버전의 아이콘을 사용합니다. | 32 | 0x20 |
생략하면 기본값은 0이고, 이것은 아이콘이 없다는 뜻입니다. 아이콘은 Title이 생략되면 보이지 않습니다.
이 매개변수는 표현식일 수 있습니다.
TrayTip 풍선 창은 스크립트에 (#NoTrayIcon 또는 Menu, tray, NoIcon을 사용해) 트레이 아이콘이 없으면 보이지 않습니다. 비슷하게, 다음 REG_DWORD 값이 존재하고 0으로 설정되어 있으면, TrayTip은 작동하지 않습니다:
HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced >> EnableBalloonTips
관련하여 말씀 드리자면, 사용자가 마우스를 스크립트의 트레이 아이콘 위에 올릴 때마다 툴팁이 보여집니다. 이 툴팁의 내용은 다음과 같이 바꿀 수 있습니다: Menu, Tray, Tip, My New Text.
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을 영원히 보여주려면, 타이머를 사용하여 주기적으로 갱신하십시오: SetTimer, RefreshTrayTip, 1000 Gosub, RefreshTrayTip ; 한 번만 호출하면 즉시 시작합니다. return RefreshTrayTip: TrayTip, Refreshed TrayTip, 이것은 거의 영구적인 TrayTip입니다., , 16 return