Vcl.Forms.TApplication.MessageBox

De RAD Studio API Documentation
Aller à : navigation, rechercher

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.


Voir aussi

Exemples de code