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 */;
Inhaltsverzeichnis
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 ein Titel nicht angegeben werden muss. (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 beliebigen Positionen angezeigt werden kann.
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).
MessageDlgPos gibt den Wert der vom Benutzer ausgewählten Schaltfläche zurück. Die Tabelle auf der Seite Vcl.Dialogs.TMsgDlgBtn zeigt die möglichen Werte für alle Schaltflächentypen und die entsprechenden Rückgabewerte.
Hinweis: Der Text der Meldung kann zur Laufzeit mit der Tastenkombination Strg+C in die Zwischenablage kopiert werden.
Mit mtConfirmation ein Fragezeichen anzeigen lassen
Dialogfelder vom Typ TMsgDlgType.mtConfirmation zeigen ein Informationssymbol an.
In der Vergangenheit wurde stattdessen ein Fragezeichen angezeigt, trotzdem hat Microsoft das Fragezeichensymbol aus der Windows-API-Funktion, die VCL zur Anzeige von TMsgDlgType.mtConfirmation-Dialogfelder verwendet, entfernt. Zitat Microsoft:
- "Das Fragezeichen-Meldungssymbol wird nicht mehr empfohlen, da es nicht eindeutig für einen bestimmten Meldungstyp steht und die Frageform einer Meldung auf jeden Meldungstyp angewendet werden könnte. Zudem könnten Benutzer das Fragezeichen-Meldungssymbol mit Hilfeinformationen verwechseln."
Setzen Sie die UseLatestCommonDialogs-Variable der Vcl.Dialogs-Unit auf False, um das vorherige Erscheinungsbild des Dialogfeldes zu verwenden.