Vcl.Dialogs.TaskMessageDlgPos

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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 */;

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 einer bestimmten Position des Bildschirms an.

Mit TaskMessageDlgPos können Sie an einer bestimmten Position des Bildschirms ein Meldungsfenster anzeigen. (Wenn Sie ein Fenster mit einem bestimmten Titel benötigen, verwenden Sie MessageDlg).

Der Parameter Msg enthält die angezeigte Meldung.

Der Parameter DlgType bestimmt den Typ des Meldungsfensters. Für eine Liste der verfügbaren Werte, siehe die Seite Vcl.Dialogs.TMsgDlgType.

Der Parameter Buttons legt fest, welche Schaltflächen das Meldungsfenster enthält. Buttons ist vom Typ Vcl.Dialogs.TMsgDlgButtons.

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 die Standardschaltfläche ist. Der Wert mbNo bedeutet, dass es keine Standardschaltfläche gibt. Für eine Liste mit den verfügbaren Aufzählungen, siehe die Seite Vcl.Dialogs.TMsgDlgType.

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 MessageDlgPos gibt an, welche Schaltfläche der Benutzer ausgewählt hat. Die Tabelle auf der Seite Vcl.Dialogs.TMsgDlgBtn zeigt die möglichen Werte für alle Schaltflächentypen und die entsprechenden Rückgabewerte.

Anmerkung:  Der Text der Meldung kann zur Laufzeit mit der Tastenkombination Strg+C in die Zwischenablage kopiert werden.

Siehe auch

Codebeispiele