Vcl.Dialogs.TaskMessageDlgPosHelp
Delphi
function TaskMessageDlgPosHelp(const Title, Msg: string; DlgType: TMsgDlgType;
Buttons: TMsgDlgButtons; HelpCtx: Longint; X, Y: Integer;
const HelpFileName: string): Integer;
function TaskMessageDlgPosHelp(const Title, Msg: string; DlgType: TMsgDlgType;
Buttons: TMsgDlgButtons; HelpCtx: Longint; X, Y: Integer;
const HelpFileName: string; DefaultButton: TMsgDlgBtn): Integer;
function TaskMessageDlgPosHelp(const Title, Msg: string; DlgType: TMsgDlgType;
Buttons: TMsgDlgButtons; HelpCtx: Longint; X, Y: Integer;
const HelpFileName: string; DefaultButton: TMsgDlgBtn; CustomButtonCaptions: array of string): Integer;
C++
extern DELPHI_PACKAGE int __fastcall TaskMessageDlgPosHelp(const System::UnicodeString Title, const System::UnicodeString Msg, System::Uitypes::TMsgDlgType DlgType, System::Uitypes::TMsgDlgButtons Buttons, System::LongInt HelpCtx, int X, int Y, const System::UnicodeString HelpFileName)/* 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 dont l'aide est fournie dans un fichier d'aide nommé.
Appelez TaskMessageDlgPosHelp pour afficher une boîte de message lorsque l'aide associée vient d'un fichier d'aide autre que celui par défaut.
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.
HelpCtx spécifie l'ID de contexte de la rubrique d'aide dans le fichier spécifié par HelpFileName. Cette rubrique apparaît quand l'utilisateur clique sur le bouton d'aide ou appuie sur F1 lorsque le dialogue est affiché.
X et Y spécifient les coordonnées écran où le dialogue doit apparaître.
HelpFileName indique le fichier d'aide qui contient la rubrique de cette boîte de message.
MessageDlgPosHelp 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 |
|
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.