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)