Affiche une simple boîte de message, avec temporisation optionnelle.
MsgBox ( flag, "title", "text" [, timeout = 0 [, hwnd]] )
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. |
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) |
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 |
InputBox, SplashTextOn, ToolTip, TrayTip