MessageBox

 

 

Cette fonction affiche une chaîne de caractères dans une boîte de messages. Utile pour donner des informations ou avertissements à l'utilisateur (Fin d'une tâche ou erreur).


int WINAPI MessageBox( HWND, LPCTSTR, LPCTSTR, UINT );

Le premier argument est un handle de fenêtre. Elle indique à quelle fenêtre se rapporte la boîte de messages. Cette valeur pourra être à NULL lorsque votre application ne possède pas encore de fenêtre (Erreur rencontrée lors de l'initialisation par exemple).

Le deuxième argument est la chaîne de caractères à afficher.

Le troisième argument est une chaîne de caractères affichée dans la barre de titre de la boîte de messages.

Le dernier argument est une constante ou une combinaison de constantes (Utiliser alors le séparateur " | "...ou logique !) et va permettre d'indiquer le/les boutons et l'icône à afficher dans la boîte.

Liste des valeurs possibles:

UINT Description

Valeur Désignation
MB_ABORTRETRYIGNORE Affichage des boutons Annuler, réessayer et ignorer
MB_DEFBUTTON1 Le premier bouton de la MessageBox sera le bouton pris par defaut.
MB_DEFBUTTON2 Le deuxième bouton de la MessageBox sera le bouton pris par defaut.
MB_DEFBUTTON3 Le troisième bouton de la MessageBox sera le bouton pris par defaut.
MB_ICONEXCLAMATION L'icone de la MessageBox sera un point d'exclamation.
MB_ICONINFORMATION L'icone de la MessageBox sera un i d'information.
MB_ICONQUESTION L'icone de la MessageBox sera un point d'interrogation.
MB_ICONSTOP L'icone de la MessageBox sera panneau stop.
MB_OK Affichage du bouton OK
MB_OKCANCEL Affichage des boutons OK et Annuler
MB_RETRYCANCEL Affichage des boutons Réessayer et Annuler.
MB_YESNO Affichage des es boutons Oui et Non.

MB_YESNOCANCEL

Affichage des boutons Oui, Non et Annuler.

 

MessageBox retourne une valeur qui permet d'identifier le bouton pressé par l'utilisateur:

Valeur Désignation
IDOK Le bouton Ok a été sélectionné.
IDCANCEL Le bouton Annuler a été sélectionné.
IDIGNORE Le bouton Ignorer a été sélectionné.
IDRETRY Le bouton Réessayer a été sélectionné.
IDNO Le bouton Non a été sélectionné.
IDYES Le bouton Oui a été sélectionné.

 

Annexe

Cf. MessageBox C++ après VC6