Vcl.Dialogs.TaskMessageDlgPos
Delphi
function TaskMessageDlgPos(const Title, Msg: string; DlgType: TMsgDlgType;
Buttons: TMsgDlgButtons; HelpCtx: Longint; X, Y: Integer): Integer;
function TaskMessageDlgPos(const Title, Msg: string; DlgType: TMsgDlgType;
Buttons: TMsgDlgButtons; HelpCtx: Longint; X, Y: Integer;
DefaultButton: TMsgDlgBtn): Integer; overload;
C++
extern DELPHI_PACKAGE int __fastcall TaskMessageDlgPos(const System::UnicodeString Title, const System::UnicodeString Msg, System::Uitypes::TMsgDlgType DlgType, System::Uitypes::TMsgDlgButtons Buttons, int HelpCtx, int X, int Y)/* overload */;
Sommaire
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 aux coordonnées de l'écran spécifiées.
Appelez TaskMessageDlgPos pour afficher une boîte de message à un endroit particulier lorsque vous n'avez pas besoin de spécifier un libellé. (Si vous avez besoin de spécifier également le libellé, utilisez la fonction MessageDlg.)
Msg représente le contenu du message qui apparaît.
DlgType indique la fonction du dialogue. Voir la page Vcl.Dialogs.TMsgDlgType pour une liste de valeurs possibles.
Buttons indique quels boutons doivent apparaître dans la boîte de message. Buttons est du type Vcl.Dialogs.TMsgDlgButtons.
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 quel bouton parmi ceux spécifiés par Buttons est le bouton par défaut pour le dialogue. Si DefaultBtn vaut mbNo, il n'y a pas de bouton par défaut. Voir la page Vcl.Dialogs.TMsgDlgType pour une liste d'énumérations possibles.
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.
MessageDlgPos renvoie la valeur du bouton sélectionné par l'utilisateur. Le tableau sur la page Vcl.Dialogs.TMsgDlgBtn énumère les valeurs 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.
Remarque : Si l'utilisateur tape CTRL+C dans la boîte de message, le texte du message est copié dans le Presse-papiers.
Définir mtConfirmation pour afficher un poin
Les boîtes de dialogue du type TMsgDlgType.mtConfirmation affichent une icône d'information.
Dans le passé, elles affichaient un point d'interrogation, mais Microsoft a retiré le symbole point d'interrogation de la fonction de l'API Windows utilisée par VCL pour afficher les boîtes de dialogue TMsgDlgType.mtConfirmation. Citation de Microsoft :
- "L'icône point d'interrogation affichant un message n'est plus recommandée parce qu'elle ne représente pas clairement un type de message spécifique et que la formulation d'un message sous la forme d'une question peut s'appliquer à tout type de message. Par ailleurs, les utilisateurs peuvent confondre le point d'interrogation affichant un message avec les informations de l'Aide."
Pour utiliser l'apparence antérieure de la boîte de dialogue, vous devez définir la variable UseLatestCommonDialogs de l'unité Vcl.Dialogs sur False.