Le Centre W..D..

Meilleure résolution
mode 800 x 600

Optimisé pour
IE v.5
Netscape v.6
mais surtout pour
Mozilla v.1
minimum

Membre de Click-FR®, Réseau francophone Paie-Par-Click

MessageBox

Date de parution : 11/04/2000 - Cette fiche API a été lue 1535 fois

Description

MessageBox crée, affiche et gère une boîte de message. La boîte de message contient un message d'information prédéfini et un titre ainsi qu'une combinaison d'icônes prédéfinis et de boutons poussoirs.

Syntaxe

AppelDLL32("user32", "MessageBoxA", hwnd, &lpText, &lpCaption, wType)

hWnd

Handle de la fenêtre propriétaire de la boîte de message qui va être créée. Si ce paramètre est à NULL, la boîte n'aura pas de propriétaire.

lpText

Pointe sur une chaîne à terminateur nul contenant le message à afficher.

lpCaption

Pointe sur une chaîne à terminateur nul contenant le titre de la boîte. Si ce paramètre est à NULL, le titre par défaut Erreur est utilisé.

wType

Spécifie le contenu et le comportement de la boîte de dialogue. Ce paramètre peut être une combinaison des valeurs suivantes :

Valeur	Signification
MB_ABORTRETRYIGNORE	La boîte contient trois boutons : Annuler, Réessayer et Ignore.
MB_APPLMODAL	L'utilisateur doit répondre à la boîte avant de continuer à travailler dans l'application identifié par le paramètre hWnd. Cependant, il peut se déplacer vers d'autres.
MB_DEFAULT_DESKTOP_ONLY	The desktop currently receiving input must be a default desktop; otherwise, the function fails. A default desktop is one an application runs on after the user has logged on.
MB_DEFBUTTON1	Le 1e bouton est celui par défaut.
MB_DEFBUTTON2	Le 2e bouton est celui par défaut.
MB_DEFBUTTON3	Le 3e bouton est celui par défaut.
MB_DEFBUTTON4	Le 4e bouton est celui par défaut.
MB_HELP	Windows 95: Ajoute un bouton d'aide. Choisir ce bouton ou appuyer sur F1 génère un événement Aide.
MB_ICONASTERISK	Idem à MB_ICONINFORMATION.
MB_ICONERROR	Windows 95: idem à MB_ICONHAND.
MB_ICONEXCLAMATION	Un symbole point d'exclamation apparaît dans la boîte.
MB_ICONHAND	Idem à MB_ICONSTOP.
MB_ICONINFORMATION	Un symbole i d'information apparaît dans la boîte.
MB_ICONQUESTION	Un symbole question apparaît dans la boîte.
MB_ICONSTOP	Un symbole stop apparaît dans la boîte.
MB_ICONWARNING	Windows 95 : Idem à MB_ICONEXCLAMATION.
MB_OK	La boîte contient un seul bouton : OK.
MB_OKCANCEL	La boîte contient deux boutons : OK et Annuler.
MB_RETRYCANCEL	La boîte contient deux boutons : Réessayer et Annuler.
MB_RIGHT	Windows 95 : Le texte est justifié à droite.
MB_RTLREADING	Windows 95 : Affiche le message et le titre de droite à gauche (pour les systèmes Arabe ou Hébreu.
MB_SERVICE_NOTIFICATION	Windows NT : L'appelant est un service notifiant l'utilisateur d'un évènement. La fonction affiche une boîte de message sur le bureau actif même si aucun utilisateur n'est logué. Si ce sémaphore est mis, le paramètre hWnd doit être à NULL.
MB_SETFOREGROUND	La boîte vient à l'avant-plan. En interne, Windows appelle la fonction SetForegroundWindow pour la boîte.
MB_SYSTEMMODAL	Toutes les applications sont suspendues tant que l'utilisateur ne réponds pas à la boîte. A utiliser pour des situations graves telles que des problèmes de mémoire.
MB_TASKMODAL	Idem à MB_APPLMODAL excepté que toutes les fenêtres au niveau supérieur sont désactivées si le paramètre hWnd est à NULL.
MB_YESNO	La boîte contient deux boutons : Oui et Non.
MB_YESNOCANCEL	La boîte contient trois boutons : Oui, Non et Annuler.

Compatibilité

Toutes versions

Remarque

Les boutons placés dans la boîte de message peuvent retourner les valeurs suivantes :

IDABORT = 3

IDCANCEL = 2

IDCONTINUE = 5

IDIGNORE = 5

IDNO = 7

IDOK = 1

IDRETRY = 4

IDTRYAGAIN = 4

IDYES = 6

Exemple 1

// Afficher une boîte Réessayer/Annuler // avec un symbole Stop !

hWnd est un entier long lpText est une chaîne asciiz sur 255 lpCaption est une chaîne asciiz sur 255 wType est un entier long RetVal est un entier long


// Paramétrage des variables

hWnd = 
Handle()

lpText = 
"Voulez-vous vraiment refaire cette opération ?"

lpCaption = "Avertissement"
// Valeur MB_RETRYCANCEL = 0x5 et MB_ICONSTOP = 0x10

wType = 0x5 + 0x10

// Ce code vous est offert par Beaussier en ligne

RetVal = 
AppelDLL32("user32", 
"MessageBoxA", 
hWnd, 
&lpText, 
&lpCaption, 
wType)
Si RetVal = 4 Alors

Info("On réessaye")

Sinon

Info("On abandonne")
Fin

Nombre de commentaire sur MessageBox : 0

Rappel : Le code fourni est compatible Windev v.4 et 5. Pour les versions supérieures, vous devez modifier le type des variables numériques. Par exemple : entier long devient entier.
Bien sûr, les marques citées sont déposées par leurs sociétés respectives. Ces pages sont à la disposition de tous, le code fourni est libre mais toute responsabilité est déclinée en cas de mauvais usage ou de dysfonctionnement.
© 2000-2005 Beaussier & Le Centre W..D..