FMX.Dialogs.MessageDlg

• Übergeordnet: FMX.Dialogs

Delphi

function MessageDlg(const AMessage: string; const ADialogType: TMsgDlgType; const AButtons: TMsgDlgButtons; const AHelpContext: LongInt): Integer;
procedure MessageDlg(const AMessage: string; const ADialogType: TMsgDlgType; const AButtons: TMsgDlgButtons; const AHelpContext: LongInt; const ACloseDialogProc: TInputCloseDialogProc);
procedure MessageDlg(const AMessage: string; const ADialogType: TMsgDlgType; const AButtons: TMsgDlgButtons; const AHelpContext: LongInt; const ACloseDialogEvent: TInputCloseDialogEvent; const AContext: TObject);
function MessageDlg(const AMessage: string; const ADialogType: TMsgDlgType; const AButtons: TMsgDlgButtons; const AHelpContext: LongInt; const ADefaultButton: TMsgDlgBtn): Integer;
procedure MessageDlg(const AMessage: string; const ADialogType: TMsgDlgType; const AButtons: TMsgDlgButtons; const AHelpContext: LongInt; const ADefaultButton: TMsgDlgBtn; const ACloseDialogProc: TInputCloseDialogProc);
procedure MessageDlg(const AMessage: string; const ADialogType: TMsgDlgType; const AButtons: TMsgDlgButtons; const AHelpContext: LongInt; const ADefaultButton: TMsgDlgBtn; const ACloseDialogEvent: TInputCloseDialogEvent; const AContext: TObject);

C++

extern DELPHI_PACKAGE int __fastcall MessageDlg(const System::UnicodeString AMessage, const System::Uitypes::TMsgDlgType ADialogType, const System::Uitypes::TMsgDlgButtons AButtons, const int AHelpContext)/* overload */;

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
function	public	FMX.Dialogs.pas FMX.Dialogs.hpp	FMX.Dialogs	FMX.Dialogs

Beschreibung

Zeigt ein benutzerdefiniertes Dialogfeld an.

Mit MessageDlg können Sie ein Dialogfeld anzeigen, dessen Erscheinungsbild den folgenden Funktionsparametern entspricht:

• AMessage repräsentiert die Textmeldung des Dialogfeldes.
• ADialogType repräsentiert den Typ des Dialogfeldes.
  • Eine Liste der Dialogfeldtypen finden Sie unter System.UITypes.TMsgDlgType.
• AButtons repräsentiert die Schaltflächen des Dialogfeldes. Die gültigen Schaltflächen-Kombinationen finden stehen als Konstanten in FMX.Dialogs#Konstanten zur Verfügung.
  • Eine Liste der Schaltflächentypen finden Sie unter System.UITypes.TMsgDlgBtn.
  • Zum Beispiel: mbYes.
• AHelpContext gibt die ID des Hilfekontexts für das Dialogfeld an.
• ADefaultButton legt fest, dass die Schaltfläche den Fokus besitzt, wenn das Dialogfeld angezeigt wird.
  • Eine Liste der Schaltflächentypen finden Sie unter System.UITypes.TMsgDlgBtn.
• ACloseDialogProc ist eine anonyme Methode, die beim Schließen des Dialogfeldes von MessageDlg ausgeführt wird.

Der Rückgabewert von MessageDlg gibt an, welche Schaltfläche der Benutzer ausgewählt hat. Wenn Sie den Parameter ACloseQueryProc angeben, übergibt InputQuery die ausgewählte Schaltfläche stattdessen an die Methode ACloseQueryProc.

Die folgende Tabelle enthält die möglichen Rückgabewerte:

TMsgDlgBtn-Wert	Rückgabewert
mbOK	mrOk
mbCancel	mrCancel
mbAbort	mrAbort
mbRetry	mrRetry
mbIgnore	mrIgnore
mbYes	mrYes
mbNo	mrNo
mbClose	mrClose
mbHelp	mrHelp
mbTryAgain	mrTryAgain
mbContinue	mrContinue
mbNone	mrNone
mbAll	mrAll
mbNoToAll	mrNoToAll
mbYesToAll	mrYesToAll

Hinweis: Die Schaltfläche Hilfe gibt keinen Wert zurück, weil damit das Dialogfeld nicht geschlossen wird. Siehe TCommonDialog.HelpContext.

Wenn im Aufruf von MessageDlg der Parameter ACloseDialogProc nicht enthalten ist, wird der Aufruf auf allen Plattformen blockiert; d. h., MessageDlg kehrt erst zurück, wenn das Dialogfeld geschlossen wird. Android unterstützt keine blockierenden Aufrufe; Sie können MessageDlg unter Android nur verwenden, wenn Sie den Parameter ACloseDialogProc angeben.

Aufrufe von MessageDlg, die den Parameter ACloseDialogProc enthalten, werden auch auf Desktop-Plattformen blockiert, nicht jedoch auf mobilen Plattformen. D. h., dass auf mobilen Plattformen Quelltext, der sich nach einem Aufruf von MessageDlg befindet, ausgeführt wird, bevor das Dialogfeld geschlossen wird. Wenn Sie nach dem Schließen des Dialogfeldes Quelltext ausführen müssen, verwenden Sie den Parameter ACloseDialogProc von MessageDlg, um eine anonyme Methode zu definieren, die diesen Code ausführt. Siehe:

• Anonyme Methoden in Delphi

• Behandlung der anonymen Methoden von Delphi in C++

Plattformunterstützung

Die folgende Tabelle enthält eine Übersicht über die Unterstützung von Aufrufen von MessageDlg auf der jeweiligen Plattform und ob diese Aufrufe blockierend oder nicht blockierend sind:

Plattform	Ohne ACloseDialogProc	Mit ACloseDialogProc
Windows	Blockierend	Blockierend
Mac OS X	Blockierend	Blockierend
iOS	Blockierend	Nicht blockierend
Android		Nicht blockierend

Siehe auch

• System.UITypes.TMsgDlgType
• System.UITypes.TMsgDlgBtn
• System.UITypes.TMsgDlgButtons

• FMX.Dialogs.InputBox
• FMX.Dialogs.InputQuery
• FMX.Dialogs.ShowMessage

• Datenmengen öffnen und schließen

Codebeispiele

• FileExists (Delphi)
• FileExists (C++)
• TStringBuilderClickCount (Delphi)
• TStringBuilderClickCount (C++)
• MessageAlerts (Beispiel) (Beispiel)