Ändert das Tray-Symbol des Skripts (das auch von GUI und Dialogfenstern verwendet wird).
TraySetIcon DateiName, SymbolNummer, Einfrieren
Typ: Zeichenkette
Wenn weggelassen, wird das aktuelle Tray-Symbol verwendet, was nur für Einfrieren von Bedeutung ist. Andernfalls geben Sie den Pfad zu einer Symbol- oder Bilddatei, ein Bitmap- oder Symbol-Handle wie "HICON:" handle
, oder ein Sternchen (*) an, um das Standardsymbol des Skripts wiederherzustellen.
Eine Liste unterstützter Formate finden Sie unter Picture.
Typ: Integer
Wenn weggelassen, wird standardmäßig 1 verwendet (die erste Symbolgruppe in der Datei). Andernfalls geben Sie die Nummer der Symbolgruppe an, die verwendet werden soll. Zum Beispiel bewirkt 2
, dass das Standardsymbol aus der zweiten Symbolgruppe geladen wird. Wenn negativ, wird der Absolutwert als Ressourcen-ID eines Symbols innerhalb einer EXE-Datei vermutet. Wenn DateiName weggelassen wird, wird SymbolNummer ignoriert.
Typ: Boolesch
Wenn weggelassen, bleibt der gefrorene/ungefrorene Zustand des Symbols unverändert.
Wenn true, wird das Symbol eingefroren, d.h. es kann nicht durch Pause oder Suspend geändert werden.
Wenn false, wird das Symbol aufgetaut.
Um das aktuelle Symbol einzufrieren (oder aufzutauen), verwenden Sie die Funktion wie folgt: TraySetIcon(,, true)
.
Das Ändern des Tray-Symbols ändert auch das angezeigte Symbol in InputBox und danach erstellte GUI-Fenster. Kompilierte Skripte sind davon ebenfalls betroffen, selbst wenn beim Kompilieren ein benutzerdefiniertes Symbol angegeben wurde. Hinweis: Das Ändern des Symbols wird das Tray-Symbol nicht sichtbar machen, wenn es zuvor mit Mitteln wie #NoTrayIcon versteckt wurde; verwenden Sie stattdessen A_IconHidden := false
.
Es können leichte Verformungen auftreten, wenn Tray-Symbole aus anderen Dateitypen als ICO geladen werden. Dieses Problem tritt insbesondere bei 16x16-Symbolen auf. Um das zu verhindern, speichern Sie das gewünschte Tray-Symbol in eine ICO-Datei.
Es gibt einige Symbole in den DLL- und CPL-Dateien des Betriebssystems, die nützlich sein können. Zum Beispiel: TraySetIcon "Shell32.dll", 174
.
Die internen Variablen A_IconNumber und A_IconFile enthalten die Nummer und den Namen (mit vollständigem Pfad) des aktuellen Symbols (beide sind leer, wenn das Standardsymbol verwendet wird).
Um den Tooltip des Symbols zu ändern, weisen Sie A_IconTip einen Wert zu.