TApplication.MessageBox Méthode
Affiche à l'utilisateur le message spécifié.
Classe
TApplication
Syntaxe
[Delphi] public function MessageBox(const Text: PAnsiChar, const Caption: PAnsiChar, Flags: Integer): Integer;
Description
Utilisez MessageBox pour afficher une boîte de dialogue générique contenant un message et un ou plusieurs boutons. Le paramètre facultatif Caption indique le titre de la boîte de dialogue.
MessageBox encapsule la fonction MessageBox de l'API Windows. L'encapsulation de MessageBox par TApplication fournit automatiquement le paramètre handle de fenêtre nécessaire à la fonction de l'API Windows.
Le paramètre Text spécifie le message qui peut si nécessaire dépasser 255 caractères. Les messages longs sont automatiquement renvoyés à la ligne dans la boîte message.
La valeur du paramètre Caption indique le titre apparaissant dans la barre de titre de la boîte de dialogue. Les titres peuvent faire plus de 255 caractères, mais ils ne sont pas renvoyés à la ligne. Un titre long produit une boîte de dialogue large.
Le paramètre Flags indique les boutons apparaissant dans la boîte message et le comportement (valeurs renvoyées possibles). Le tableau ci-dessous énumère les valeurs possibles. Ces valeurs peuvent se combiner pour donner le résultat souhaité.
Valeur Signification
MB_ABORTRETRYIGNORE
La boîte message contient trois boutons poussoir : Abandonner, Réessayer et Ignorer.
MB_OK
La boîte message contient un bouton poussoir : OK. Il s'agit de la valeur par défaut.
MB_OKCANCEL
La boîte message contient deux boutons poussoir : OK et Annuler.
MB_RETRYCANCEL
La boîte message contient deux boutons poussoir : Réessayer et Annuler.
MB_YESNO
La boîte message contient deux boutons poussoir : Oui et Non.
MB_RETRYCANCEL
La boîte message contient trois boutons poussoir : Oui, Non et Annuler.
MessageBox renvoie 0 s'il n'y a pas assez de mémoire pour créer la boîte message. Sinon, elle renvoie l'une des valeurs suivantes :
Valeur Valeur numérique Signification
Valeur Valeur numérique Signification
IDOK 1 L'utilisateur a choisi le bouton OK.
IDCANCEL 2 L'utilisateur a choisi le bouton Annuler.
IDABORT 3 L'utilisateur a choisi le bouton Abandonner.
IDRETRY 4 L'utilisateur a choisi le bouton Réessayer.
IDIGNORE 5 L'utilisateur a choisi le bouton Ignorer.
IDYES 6 L'utilisateur a choisi le bouton Oui.
IDNO 7 L'utilisateur a choisi le bouton Non.
Partager