Vcl.Dialogs.MessageDlg

Übergeordnet: Vcl.Dialogs

Delphi

function MessageDlg(const Msg: string; DlgType: TMsgDlgType;
Buttons: TMsgDlgButtons; HelpCtx: Longint): Integer;
function MessageDlg(const Msg: string; DlgType: TMsgDlgType;
Buttons: TMsgDlgButtons; HelpCtx: Longint; DefaultButton: TMsgDlgBtn): Integer; overload;
function MessageDlg(const Msg: string; DlgType: TMsgDlgType;
Buttons: TMsgDlgButtons; HelpCtx: Longint; DefaultButton: TMsgDlgBtn; CustomButtonCaptions: array of string): Integer; overload;

C++

extern DELPHI_PACKAGE int __fastcall MessageDlg(const System::UnicodeString Msg, System::Uitypes::TMsgDlgType DlgType, System::Uitypes::TMsgDlgButtons Buttons, System::LongInt HelpCtx)/* overload */;

Inhaltsverzeichnis

1 Eigenschaften
2 Beschreibung

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 Meldungsdialogfeld an.

Mit MessageDlg zeigen Sie ein Meldungsfenster an und rufen eine Benutzerantwort ab.

Der Parameter Msg enthält die angezeigte Meldung.

Der Parameter DlgType bestimmt den Typ des Meldungsfensters.

Der Parameter Buttons legt fest, welche Art von Schaltflächen für das Meldungsfenster verwendet werden soll. Die 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.

Der Parameter DefaultBtn legt fest, welche der Schaltflächen in Buttons die Standardschaltfläche (fokussierte Schaltfläche) ist.

Der Rückgabewert von MessageDlg gibt an, welche Schaltfläche der Benutzer ausgewählt hat.

Die Tabelle auf der Seite Vcl.Dialogs.TMsgDlgButtons zeigt die möglichen Werte für alle Arten von Schaltflächen, die das Meldungsfenster enthalten kann, und die entsprechenden Rückgabewerte an.

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`

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.