Functions > MessageBoxesDialogs >


SplashTextOn

Crée une fenêtre surgisssante avec un texte personnalisé.

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