# Funktionsreferenz

SplashTextOn

Erzeugt ein einstellbares Text-Anzeigefenster.

SplashTextOn ( "title", "text" [, w [, h [, x pos [, y pos [, opt [, "fontname" [, "fontsz" [, "fontwt"]]]]]]]] )

Parameter

title | Titel des Splash Fensters.
text | Text des Splash Fensters.
w | [optional] Breite des Fensters in Pixel (Vorgabe 500).
h | [optional] Höhe des Fensters in Pixel (Vorgabe 400).
x pos | [optional] Position von Links (in Pixel - Vorgabe ist zentriert).
y pos | [optional] Position von Oben (in Pixel - Vorgabe ist zentriert).
opt | [optional] Addierbare Optionen - Vorgabe ist 0: 0 = Zentriert ausgerichtet / Immer im Vordergrund / mit Titel (Vorgabe 1 = Dünne Aussenlinien, Titelloses Fenster. 2 = Ohne "immer im Vordergrund" Attribut. 4 = Linksbündiger Text. 8 = Rechtsbündiger Text. 16 = Fenster kann bewegt werden.
fontname | [optional] Schriftname. (OS GUI Vorgabe-Schrift wird genutzt wenn die Schrift "" ist oder nicht gefunden wurde)
fontsz | [optional] Schriftgröße. (Vorgabe ist 12; Standard Größen sind 6 8 9 10 11 12 14 16 18 20 22 24 26 28 36 48 72)
fontwt | [optional] Schriftbreite (0 - 1000, Vorgabe = 400 = normal). Ein Wert > 1000 wird als 0 behandelt.

Bemerkungen

Um einen optionalen Parameter zu überspringen, lasse seinen Vorgabewert intakt, benutze:
"" für einen Text Parameter.
-1 für einen zahlenmäßigen Parameter.
Nur ein SplashImage/Text Fenster ist zur selben Zeit erlaubt. Sollen verschiedene Image/Text Fenster durgegangen werden, rufe SplashImageOn/SplashTextOn wiederholt mit den neuen Informationen auf.
Besser ist es die Funktion ControlSetText zu benutzen, um Text ohne flackern zu aktualisieren...
Enthaltene Standard Schriftnamen:
Arial, Comic Sans MS, Courier New, Lucida Console, Microsoft Sans Serif, System, Tahoma, Times New Roman, and WingDings
Siehe Anlage für eine komplette Schritartenliste.

Siehe auch

SplashOff, SplashImageOn, ControlSetText, ToolTip

Beispiel

SplashTextOn("Title", "Message goes here.", -1, -1, -1, -1, 4, "", 24)
Sleep(3000)
SplashOff()
;; FLICKER
$message = ""
SplashTextOn("TitleFoo", $message, -1, -1, -1, -1, 4, "")
For $x = 1 to 20
$message = $message & $x & @LF
SplashTextOn("TitleFoo", $message, -1, -1, -1, -1, 4, "")
Sleep(100)
Next
;; SMOOTH
$message = ""
SplashTextOn("TitleFoo", $message, -1, -1, -1, -1, 4, "")
For $x = 1 to 20
$message = $message & $x & @LF
ControlSetText("TitleFoo", "", "Static1", $message)
sleep(100)
Next