Function Reference

SplashTextOn

Creates a customizable text popup window.

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

 

Parameters

title Title for splash window.
text Text for splash window.
w [optional] Width of window in pixels. (default 500)
h [optional] Height of window in pixels. (default 400)
x pos [optional] Position from left (in pixels) of splash window. (default is centered)
y pos [optional] Position from top (in pixels) of splash window. (default is centered)
opt [optional] Add them up - default is 'center justified/always on top/with title'
 0 = Center justified/always on top/with title (default)
 1 = Thin bordered titleless window
 2 = Without "always on top" attribute
 4 = Left justified text
 8 = Right justified text
16 = Windows can be moved
fontname [optional] Font to use. (OS default GUI font is used if the font is "" or is not found)
fontsz [optional] Font size. (default is 12; standard sizes are 6 8 9 10 11 12 14 16 18 20 22 24 26 28 36 48 72)
fontwt [optional] Font weight (0 - 1000, default = 400 = normal). A value > 1000 is treated as zero.

 

Return Value

None.

 

Remarks

To skip an optional parameter, leaving it's default value intact, use:
    "" for a string parameters
    -1 for a numeric parameters

Only one SplashImage/Text window is allowed at one time; so if you wish to cycle through multiple images/text, simply call SplashImageOn/SplashTextOn again with the new information.

Even better is to use ControlSetText to update text without flicker...

Standard font names include:
    Arial, Comic Sans MS, Courier New, Lucida Console, Microsoft Sans Serif, System, Tahoma, Times New Roman, and WingDings
See Appendix for a complete font list

 

Related

SplashOff, SplashImageOn, ControlSetText, ToolTip

 

Example


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