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 */;
Inhaltsverzeichnis
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | Vcl.Dialogs.pas Vcl.Dialogs.hpp |
Vcl.Dialogs | Vcl.Dialogs |
Beschreibung
Zeigt in der Mitte des Bildschirms ein Meldungs-Task-Dialogfeld an.
Mit TaskMessageDlg zeigen Sie ein Meldungsfenster an und rufen eine Benutzerantwort ab.
Caption legt den Titel des Meldungsfensters fest, wenn DlgType gleich mtCustom ist. Wenn dieser Parameter nicht verwendet wird, ist der Titel für benutzerdefinierte Meldungsfenster gleich dem Titel der Anwendung.
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. Verwenden Sie für ein Meldungsfenster mit drei Schaltflächen die Syntax mit Button1, Button2 und Button3.
Button1, Button2 und Button3 geben an, welche Art von Schaltfläche für das Meldungsfenster verwendet werden soll. Die resultierenden Schaltflächen werden der Reihe nach angezeigt.
Der Parameter HelpCtx ist die Kontext-ID des Hilfethemas, das angezeigt wird, wenn der Anwender auf die Schaltfläche Hilfe klickt oder F1 drückt.
Die Parameter X und Y sind die Bildschirmkoordinaten des Meldungsfensters. Der Wert -1 bedeutet, dass das Meldungsfenster an keiner bestimmten Position angezeigt wird.
Der Parameter DefaultBtn legt fest, welche der Schaltflächen in Buttons (oder Button1, Button2 und Button3) die Standardschaltfläche ist. Der Wert mbNone bedeutet, dass es keine Standardschaltfläche gibt.
Der Parameter Bitmap ist eine Grafik, die im Meldungsfenster angezeigt wird. Wenn Bitmap nil (Delphi) bzw. NULL (C++) ist, wird keine Grafik angezeigt (es sei denn, DlgType hat den Wert mtConfirmation).
Der Rückgabewert von MessageDlg 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 |
|
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.
Siehe auch
Codebeispiele