Funktionsreferenz

SplashTextOn

Erzeugt ein einstellbares Text-Anzeigefenster (PopUp).

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 (Standard 500).
h	[optional] Höhe des Fensters in Pixel (Standard 400).
x pos	[optional] Position von Links (in Pixel - Standard ist zentriert).
y pos	[optional] Position von Oben (in Pixel - Standard ist zentriert).
opt	[optional] Addierbare Optionen - Standard ist 0: Zentriert ausgerichtet / immer im Vordergrund / mit Titel 0 = Zentriert ausgerichtet / immer im Vordergrund / mit Titel (Standard) 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 32 = Text wird vertikal zentriert
fontname	[optional] Schriftname. (Wenn für fontname "" gewählt wird oder der Schrifttyp nicht gefunden wurde, wird die im OS definierte GUI Standard-Schrift genommen.)
fontsz	[optional] Schriftgröße. (Standard 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, Standard = 400 = normal). Ein Wert > 1000 wird als 0 behandelt.

Rückgabewert

Gibt das Handle des Splash-Fensters zurück, welches für ControlSetText verwendet werden kann.

Bemerkungen

Um einen optionalen Parameter zu überspringen, (also den Standardwert beizubehalten), benutzt man:
    "" für einen Text-Parameter.
    -1 für einen Zahl-Parameter.

Nur ein SplashImage/Text Fenster ist zur selben Zeit erlaubt. Sollen verschiedene Image/Text Fenster durchgegangen werden, ist SplashImageOn/SplashTextOn wiederholt mit den neuen Informationen aufzurufen.

Besser ist es, die Funktion ControlSetText zu benutzen, um Text ohne Flackern zu aktualisieren...
Wenn der Text zentriert ist und sich in mehreren Zeilen befindet, dann wird ControlSetText die Anzahl der Zeilen, welche durch SplashTextOn erstellt wurden, nicht überschreiben.

Fenster mit opt=1 können nicht bewegt bzw. durch Anklicken aktiviert werden.

Enthaltene Standard-Schriftarten:
    Arial, Comic Sans MS, Courier New, Lucida Console, Microsoft Sans Serif, System, Tahoma, Times New Roman und WingDings
Siehe Anlage für eine komplette Schritartenliste.

Um mehrere Zeilen darzustellen, ist @LF zu benutzen.

Damit innerhalb des Textes ein &-Zeichen zu erzeugen wird, muss man an dieser Stelle zwei &-Zeichen hintereinander schreiben.
Beispiel: Um Text&Text anzuzeigen, muss man Text&&Text schreiben.

Verwandte Funktionen

SplashOff, SplashImageOn, ControlSetText, ToolTip, MsgBox

Beispiel

SplashTextOn("Titel", "Nachricht hier rein.", -1, -1, -1, -1, 4, "", 24)
Sleep(3000)
SplashOff()

;; FLIMMERT
$message = ""
SplashTextOn("Titelleiste", $message, -1, -1, -1, -1, 4, "")
For $x = 1 to 20
$message = $message & $x & @LF
SplashTextOn("Titelleiste", $message, -1, -1, -1, -1, 4, "")
Sleep(100)
Next

;; FLIMMERT NICHT
$message = ""
SplashTextOn("Titelleiste", $message, -1, -1, -1, -1, 4, "")
For $x = 1 to 20
$message = $message & $x & @LF
ControlSetText("Titelleiste", "", "Static1", $message)
sleep(100)
Next