Aide:SplashTextOn.txt

Document original V3.3.6.1 :

###Function###
SplashTextOn

###Description###
Creates a customizable text popup window.

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

###Parameters###
@@ParamTable@@
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
	32 = Center text vertically
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.
@@End@@


###ReturnValue###
Return the Handle of the splash window that can be used in ControlSetText.


###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...
If the text is center and multiline, the ControlSetText will not override the number of lines created by the SplashTextOn.

Splash with opt=1 cannot be moved and cannot be activated  by click.

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

Use @LF to display several lines.


###Related###
SplashOff, SplashImageOn, ControlSetText, ToolTip, MsgBox


###Example###
@@IncludeExample@@

Document traduit V3.3.6.1 :

###Function###
SplashTextOn

###Description###
Crée une fenêtre de texte popup personnalisable


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


###Parameters###
@@ParamTable@@
title
	Titre de la fenêtre.
text
	Texte de la fenêtre splash.
w
	[optionnel] Largeur de la fenêtre en pixels. (500 par défaut)
h
	[optionnel] Hauteur de la fenêtre en pixels. (400 par défaut)
x pos
	[optionnel] position de la fenêtre splash à partir de la gauche (en pixels). (centré par défaut)
y pos
	[optionnel] position de la fenêtre splash à partir du haut (en pixels). (centré par défaut)
opt
	[optionnel] "toujours au premier plan avec titre" par défaut.
	 0 = Justifié centré/toujours au premier plan/avec titre (par défaut)
	 1 = Fenêtre sans titre à bordure mince
	 2 = sans l'attribut "toujours au premier plan"
	 4 = texte justifié à gauche
	 8 = texte justifié à droite
	16 = La fenêtre peut être déplacée
	32 = Centrer le texte verticalement
fontname
	[optionnel] Police à utiliser. (La police par défaut de l'OS est utilisée si la police est "" ou si elle n'est pas trouvée)
fontsz
	[optionnel] Taille de la police. (12 par défaut; les tailles standard sont 6 8 9 10 11 12 14 16 18 20 22 24 26 28 36 48 72)
fontwt
	[optionnel] Largeur de la police (0 à 1000, défaut = 400 = normal). Une valeur > 1000 est considérée comme nulle.
@@End@@


###ReturnValue###
Retourne le handle de la fenêtre splash qui peut être utilisé dans ControlSetText.


###Remarks###
Pour sauter un paramètre optionnel, en laissant sa valeur par défaut intacte, utilisez:
     "" pour les paramètres de chaîne
     -1 pour les paramètres numériques

Une seule fenêtre splashImage/splashtext est permise en même temps, donc si vous souhaitez faire défiler plusieurs images/textes, utilisez simplement SplashImageOn/SplashTextOn à nouveau avec les nouvelles informations.

Il est préférable d'utiliser ControlSetText pour mettre à jour le texte sans faire flasher la fenêtre.
Si le texte est centré et multi-lignes, le ControlSetText ne modifiera pas le nombre de lignes créées par le SplashTextOn.

Un splash avec opt=1 ne peut être déplacé et ne peut être activé par un clic.

Noms de polices standard incluses:
     Arial, Comic Sans MS, Courier New, Lucida Console, Microsoft Sans Serif, système, Tahoma, Times New Roman, et WingDings
Voir l'appendice pour une liste complète des polices

Utilisez @LF pour afficher plusieurs lignes.


###Related###
<a href="SplashOff.htm">SplashOff</a>, <a href="SplashImageOn.htm">SplashImageOn</a>, <a href="ControlSetText.htm">ControlSetText</a>, <a href="ToolTip.htm">ToolTip</a>, <a href="MsgBox.htm">MsgBox</a>


###Example###
@@IncludeExample@@

Traducteur : TT22

Contributeurs (pour les modifications avant le Wiki) : Tlem