Vcl.Forms.TApplication.MessageBox
Delphi
function MessageBox(const Text, Caption: PChar; Flags: Longint = MB_OK): Integer;
C++
int __fastcall MessageBox(const System::WideChar * Text, const System::WideChar * Caption, System::LongInt Flags = 0x0);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | Vcl.Forms.pas Vcl.Forms.hpp |
Vcl.Forms | TApplication |
Description
Affiche à l'utilisateur le message spécifié.
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, qui est décrite à l'adresse http://msdn.microsoft.com/en-us/library/windows/desktop/ms645505(v=vs.85).aspx.
L'encapsulation TApplication de MessageBox fournit automatiquement le paramètre handle de fenêtre nécessaire à la fonction de l'API Windows.
La valeur du paramètre Text indique le message, qui peut si nécessaire dépasser 255 caractères. Les messages longs sont automatiquement renvoyés à la ligne dans la zone de 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 suivant liste 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. C'est 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 |
|---|---|---|
|
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. |