Functions > MessageBoxesDialogs >


MsgBox

Affiche une simple boîte de message, avec temporisation optionnelle.

MsgBox ( flag, "title", "text" [, timeout = 0 [, hwnd]] )

Paramètres

flag Indique le type de boîte de message et les combinaisons de boutons possibles. Voir remarques.
title Le titre de la boîte de message.
text Le texte de la boîte de message.
timeout [optionnel] Temporisation en secondes. Après la temporisation, la boite de message sera automatiquement fermée. La valeur par défaut est 0, ce qui équivaut à aucune temporisation.
hwnd [optionnel] Le handle de la fenêtre à utiliser comme fenêtre parent pour ce dialogue.

Valeur de retour

Succès: Retourne l'ID du bouton pressé.
Échec: Retourne $IDTIMEOUT (-1) si la temporisation de la boîte de dialogue est dépassée.



Bouton pressé Valeur de retour
OK $IDOK (1)
CANCEL (Annuler) $IDCANCEL (2)
ABORT (Abandonner) $IDABORT (3)
RETRY (Recommencer) $IDRETRY (4)
IGNORE (Ignorer) $IDIGNORE (5)
YES (Oui) $IDYES (6)
NO (Non) $IDNO (7)
TRY AGAIN** (Réessayer) $IDTRYAGAIN (10)
CONTINUE** (Continuer) $IDCONTINUE (11)

Les constantes sont définies dans MsgBoxConstants.au3

Remarques

Le paramètre 'flag' peut être une combinaison des valeurs suivantes:

Nom de constante Flag Effet relatif aux boutons Flag hexadécimal
$MBOK 0 Bouton OK 0x0
$MBOKCANCEL 1 OK et Annuler 0x1
$MB_ABORTRETRYIGNORE 2 Abandonner, Recommencer, et Ignorer 0x2
$MB_YESNOCANCEL 3 Oui, Non, et Annuler 0x3
$MB_YESNO 4 Oui et Non 0x4
$MB_RETRYCANCEL 5 Recommencer et Annuler 0x5
$MB_CANCELTRYCONTINUE 6 Annuler, Réessayer, Continuer 0x6
$MB_HELP 16384 Ajouter un bouton d'aide à la boîte de message. Quand l'utilisateur clique sur le bouton Help ou presse F1, le system envoie un message WM_HELP à la fenêtre. 0x4000
Nom de constante Flag Effet relatif à l'icône Flag hexadécimal
0 pas d'icône 0x0
$MB_ICONERROR 16 Icône Stop 0x10
$MB_ICONQUESTION 32 Icône point d'interrogation 0x20
$MB_ICONWARNING 48 Icône point d'exclamation 0x30
$MB_ICONINFORMATION 64 Icône Information ('i' dans un cercle) 0x40
Nom de constante Flag Effet relatif aux valeurs par défaut Flag hexadécimal
$MB_DEFBUTTON1 0 Le premier bouton est le bouton par défaut 0x0
$MB_DEFBUTTON2 256 Le deuxième bouton est le bouton par défaut 0x100
$MB_DEFBUTTON3 512 Le troisième bouton est le bouton par défaut 0x200
$MB_DEFBUTTON4 768 Le quatrième bouton est le bouton par défaut 0x300
Nom de constante Flag Effet relatif à la modalité Flag hexadécimal
$MB_APPLMODAL 0 Application 0x0
$MB_SYSTEMMODAL 4096 Système modal (la boîte de dialogue a une icône) 0x1000
$MB_TASKMODAL 8192 Tâche modale 0x2000
Nom de constante Flag Effet divers Flag hexadécimal
0 (rien de spécial) 0x0
$MB_DEFAULT_DESKTOP_ONLY 131072 MsgBox() s'affiche sur le bureau de la fenêtre interactive. 0x20000
$MB_RIGHT 524288 Le titre et le texte sont justifiés à droite 0x80000
$MB_RTLREADING 1048576 Affiche un message et un titre en utilisant l'ordre de lecture 'droite-gauche' sur les systèmes Hebreu et Arabe. 0x100000
$MB_SETFOREGROUND 65536 La boîte de message s'ouvre en arrière plan de la fenêtre. 0x10000
$MB_TOPMOST 262144 MsgBox() possède l'attribut 'top-most' (premier plan) 0x40000
$MB_SERVICE_NOTIFICATION 2097152 La fonction affiche une boîte de message sur le bureau actif en cours, même s'il n'y a pas d'utilisateur connecté à l'ordinateur. 0x200000


Par exemple, pour spécifier une boîte SYSTEMMODAL avec les boutons YES/NO, la valeur du 'flag' serait 4096+4 (ou 4100). En utilisant les valeurs hexadécimales des flags, ce serait 0x1000+0x4 (ou 0x1004).

Une boîte de dialogue apparaît centrée sur l'écran et est redimensionnée selon le texte qu'elle contient. Cependant, le titre pourrait être tronqué si l'option SYSTEMMODAL (4096) est utilisée.

Si "title" est égal au mot-clé Default, @Scriptname est utilisé.

Note spéciale: MsgBox ne prend pas en charge l'utilisation du paramètre timeout lorsque l'indicateur $MB_SERVICE_NOTIFICATION est utilisé lorsque vous appelez MsgBox à partir d'un service. La fenêtre de boîte de message n'est pas la propriété du processus appelant MsgBox lorsque $MB_SERVICE_NOTIFICATION est spécifiée.

Les constantes sont définies dans MsgBoxConstants.au3

En relation

InputBox, SplashTextOn, ToolTip, TrayTip

Exemples

Exemple 1

#include <MsgBoxConstants.au3>

MsgBox($MB_SYSTEMMODAL, "Title", "Cette boîte de message sera fermée après 10 secondes ou si le bouton OK est pressé avant.", 10)


Exemple 2

#include <MsgBoxConstants.au3>

Local $iTimeout = 10

; Affiche une boîte de message avec une variable incluse dans le texte.
MsgBox($MB_SYSTEMMODAL, "Title", "Cette boîte de message se fermera après un délai de " & $iTimeout & " secondes ou si le bouton OK est pressé.", $iTimeout)