Vcl.Dialogs.TaskMessageDlg

De RAD Studio API Documentation
Aller à : navigation, rechercher

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.

Voir aussi