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, int HelpCtx, int X, int Y, const System::UnicodeString HelpFileName)/* overload */;
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | Vcl.Dialogs.pas Vcl.Dialogs.hpp |
Vcl.Dialogs | Vcl.Dialogs |
Beschreibung
Zeigt ein Meldungs-Task-Dialogfeld an, dessen Hilfe in einer benannten Hilfedatei bereitgestellt ist.
Rufen Sie TaskMessageDlgPosHelp auf, um ein Meldungsfenster anzuzeigen, dessen zugeordnete Hilfe nicht in der Standardhilfedatei, sondern in einer eigenen Datei enthalten ist.
Der Parameter Msg enthält die angezeigte Meldung.
Der Parameter DlgType bestimmt den Typ des Meldungsfensters.
| DlgType-Wert | Bedeutung |
|---|---|
|
mtWarning |
Ein Meldungsfenster, das ein gelbes Ausrufezeichen enthält. |
|
mtError |
Ein Meldungsfenster, das ein rotes Stoppschild enthält |
|
mtInformation |
Ein Meldungsfenster, das ein blaues "i" enthält. |
|
mtConfirmation |
Ein Meldungsfenster, das ein grünes Fragezeichen enthält. |
|
mtCustom |
Ein Meldungsfenster, das kein Bitmap enthält. Der Titel des Meldungsfensters ist der Name der ausführbaren Datei der Anwendung. |
Der Parameter Buttons legt fest, welche Schaltflächen das Meldungsfenster enthält.
HelpCtx legt die Kontext-ID für das Hilfethema in der in HelpFileName angegebenen Datei fest. Dieses Thema wird angezeigt, wenn der Benutzer auf die Schaltfläche Hilfe klickt oder F1 drückt.
Die Parameter X und Y sind die Bildschirmkoordinaten des Meldungsfensters.
HelpFileName gibt die Hilfedatei an, die das Hilfethema für dieses Meldungsfenster enthält.
Der Rückgabewert von MessageDlgPosHelp gibt an, welche Schaltfläche der Benutzer ausgewählt hat. Die folgende Tabelle zeigt die möglichen Werte für TMsgDlgBtn und die entsprechenden Rückgabewerte:
| TMsgDlgBtn-Wert | Rückgabewert |
|---|---|
|
mbOK |
mrOk |
|
mbCancel |
mrCancel |
|
mbYes |
mrYes |
|
mbNo |
mrNo |
|
mbAbort |
mrAbort |
|
mbRetry |
mrRetry |
|
mbIgnore |
mrIgnore |
|
mbAll |
mrAll |
|
mbNoToAll |
mrNoToAll |
|
mbYesToAll |
mrYesToAll |
|
mbClose |
mrClose |
Anmerkung: Der Text der Meldung kann zur Laufzeit mit der Tastenkombination Strg+C in die Zwischenablage kopiert werden.