Vcl.Dialogs.TaskMessageDlg
Delphi
function TaskMessageDlg(const Title, Msg: string; DlgType: TMsgDlgType;
Buttons: TMsgDlgButtons; HelpCtx: Longint): Integer;
function TaskMessageDlg(const Title, Msg: string; DlgType: TMsgDlgType;
Buttons: TMsgDlgButtons; HelpCtx: Longint; DefaultButton: TMsgDlgBtn): Integer; overload;
function TaskMessageDlg(const Title, Msg: string; DlgType: TMsgDlgType;
Buttons: TMsgDlgButtons; HelpCtx: Longint; DefaultButton: TMsgDlgBtn; CustomButtonCaptions: array of string): Integer; overload;
C++
extern DELPHI_PACKAGE int __fastcall TaskMessageDlg(const System::UnicodeString Title, const System::UnicodeString Msg, System::Uitypes::TMsgDlgType DlgType, System::Uitypes::TMsgDlgButtons Buttons, int HelpCtx)/* overload */;
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | Vcl.Dialogs.pas Vcl.Dialogs.hpp |
Vcl.Dialogs | Vcl.Dialogs |
Description
Affiche une boîte de dialogue de message de tâche au centre de l'écran.
Appelez TaskMessageDlg pour afficher une boîte de message et obtenir la réponse de l'utilisateur.
Caption spécifie l'intitulé de la boîte de message lorsque DlgType a la valeur mtCustom. Si ce paramètre n'est pas utilisé, l'intitulé des boîtes de message personnalisées est le titre de l'application.
Msg représente le contenu du message qui apparaît.
DlgType indique la fonction du dialogue :
| Valeur DlgType | Signification |
|---|---|
|
mtWarning |
Une boîte de message contenant un signe point d'exclamation jaune. |
|
mtError |
Une boîte de message contenant un signe de stop rouge. |
|
mtInformation |
Une boîte de message contenant un "i" bleu. |
|
mtConfirmation |
Une boîte de message contenant un point d'interrogation vert. |
|
mtCustom |
Une boîte de message ne contenant pas d'image. Le titre de la boîte de dialogue est le nom du fichier exécutable de l'application. |
Buttons indique quels boutons doivent apparaître dans la boîte de message. Pour une boîte de message à trois boutons, utilisez la syntaxe contenant Button1, Button2 et Button3.
Button1, Button2 et Button3 indiquent les types de boutons à utiliser pour une boîte de message à trois boutons. Les boutons résultants apparaissent dans l'ordre.
HelpCtx spécifie l'identificateur de contexte de la rubrique d'aide qui doit apparaître lorsque l'utilisateur clique sur le bouton d'aide ou appuie sur F1 alors que le dialogue est affiché.
X et Y spécifient les coordonnées écran où le dialogue doit apparaître. La valeur –1 signifie que la boîte de message peut apparaître n'importe où dans la dimension spécifiée.
DefaultBtn spécifie quel bouton parmi ceux spécifiés par Buttons (ou Button1, Button2 et Button3) est le bouton par défaut dans le dialogue. Si DefaultBtn vaut mbNone, il n'y a pas de bouton par défaut.
Bitmap est une image qui apparaît devant le dialogue de message. Si Bitmap a la valeur nil (Delphi) ou NULL (C++), il n'y a pas d'image, sauf si DlgType a la valeur mtConfirmation.
MessageDlg renvoie la valeur du bouton sélectionné par l'utilisateur. Le tableau suivant liste les valeurs TMsgDlgBtn pour chaque type de bouton pouvant apparaître dans la boîte de message, et la valeur correspondante qui est renvoyée si l'utilisateur sélectionne ce bouton :
| Valeur TMsgDlgBtn | Valeur renvoyée correspondante |
|---|---|
|
mbOk |
mrOk |
|
mbOK |
mrOk |
|
mbCancel |
mrCancel |
|
mbYes |
mrYes |
|
mbNo |
mrNo |
|
mbAbort |
mrAbort |
|
mbRetry |
mrRetry |
|
mbIgnore |
mrIgnore |
|
mbAll |
mrAll |
|
mbNoToAll |
mrNoToAll |
|
mbYesToAll |
mrYesToAll |
|
mbClose |
mrClose |
Remarque : Si l'utilisateur tape Ctrl+C dans la boîte de message, le texte du message est copié dans le Presse-papiers.