Functions > MessageBoxesDialogs >

SplashTextOn

Cr�e une fen�tre popup contenant un texte

SplashTextOn ( "title", "text" [, w = 500 [, h = 400 [, x pos [, y pos [, opt = 0 [, "fontname" [, fontsz = 12 [, fontwt]]]]]]]] )

Param�tres

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�e par d�faut)
y pos [optionnel] Position de la fen�tre splash � partir du haut (en pixels). (centr�e par d�faut)
opt [optionnel] Ajoutez des options - par d�faut, 'justification centr�e/toujours au premier plan/avec titre".
    $DLG_CENTERONTOP (0) = Justification centr�e/toujours au premier plan/avec titre (par d�faut)
    $DLG_NOTITLE (1) = Fen�tre sans titre � bordure mince
    $DLG_NOTONTOP (2) = Sans l'attribut "ONTOP"
    $DLG_TEXTLEFT (4) = Texte justifi� � gauche
    $DLG_TEXTRIGHT (8) = Texte justifi� � droite
    $DLG_TEXTVCENTER (16) = La fen�tre peut �tre d�plac�e
    $DLG_TEXTVCENTER (32) = Texte centr� verticalement

Les constantes sont d�finies dans AutoItConstants.au3
fontname [optionnel] Nom de la police � utiliser. (La police GUI par d�faut dans 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] La graisse de la police de 0 � 1000. Par exemple, 400 est normal et 700 est gras. Si cette valeur est 0, une graisse par d�faut est utilis�e.
Les valeurs suivantes sont d�finies pour en faciliter l'utilisation.
    $FW_DONTCARE = 0 (Utilise la graisse de police par d�faut)
    $FW_THIN = 100
    $FW_EXTRALIGHT = 200
    $FW_LIGHT = 300
    $FW_NORMAL = 400
    $FW_MEDIUM = 500
    $FW_SEMIBOLD = 600
    $FW_BOLD = 700
    $FW_EXTRABOLD = 800
    $FW_HEAVY = 900

Les constantes sont d�finies dans FontConstants.au3

Valeur de retour

Retourne le handle de la fen�tre splash qui peut �tre utilis� dans ControlSetText().

Remarques

Pour sauter un param�tre optionnel, en laissant sa valeur par d�faut inchang�e, utilisez:
    "" pour les param�tres 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, la fonction ControlSetText() ne modifiera pas le nombre de lignes cr��es par le SplashTextOn().

Une fen�tre splash avec opt=1 ne peut �tre d�plac�e et ne peut �tre activ�e par un clic.

Noms de polices standards incluses:
    Arial, Comic Sans MS, Courier New, Lucida Console, Microsoft Sans Serif, syst�me, Tahoma, Times New Roman, et WingDings
Consultez l'Appendice pour une liste compl�te des polices Windows et les versions de Windows sous lesquelles elles sont support�es.

Utilisez @LF pour afficher plusieurs lignes.

En relation

ControlSetText, MsgBox, SplashImageOn, SplashOff, ToolTip

Exemple

#include <AutoItConstants.au3>

SplashTextOn("Title", "Le message est ici.", -1, -1, -1, -1, 4, "", 24)
Sleep(3000)
SplashOff()

; ; FLICKER
Local $sMessage = ""
SplashTextOn("TitleFoo", $sMessage, -1, -1, -1, -1, $DLG_TEXTLEFT, "")
For $i = 1 To 20
    $sMessage = $sMessage & $i & @CRLF
    SplashTextOn("TitleFoo", $sMessage, -1, -1, -1, -1, $DLG_TEXTLEFT, "")
    Sleep(100)
Next

; ; SMOOTH
$sMessage = ""
SplashTextOn("TitleFoo", $sMessage, -1, -1, -1, -1, $DLG_TEXTLEFT, "")
For $i = 1 To 20
    $sMessage = $sMessage & $i & @CRLF
    ControlSetText("TitleFoo", "", "Static1", $sMessage)
    Sleep(100)
Next