FMX.Dialogs.MessageDlg
Delphi
function MessageDlg(const AMessage: string; const ADialogType: TMsgDlgType; const AButtons: TMsgDlgButtons;
const AHelpContext: THelpContext): Integer;
procedure MessageDlg(const AMessage: string; const ADialogType: TMsgDlgType; const AButtons: TMsgDlgButtons;
const AHelpContext: THelpContext; const ACloseDialogProc: TInputCloseDialogProc);
procedure MessageDlg(const AMessage: string; const ADialogType: TMsgDlgType; const AButtons: TMsgDlgButtons;
const AHelpContext: THelpContext; const ACloseDialogEvent: TInputCloseDialogEvent; const AContext: TObject);
function MessageDlg(const AMessage: string; const ADialogType: TMsgDlgType; const AButtons: TMsgDlgButtons;
const AHelpContext: THelpContext; const ADefaultButton: TMsgDlgBtn): Integer;
procedure MessageDlg(const AMessage: string; const ADialogType: TMsgDlgType; const AButtons: TMsgDlgButtons;
const AHelpContext: THelpContext; const ADefaultButton: TMsgDlgBtn; const ACloseDialogProc: TInputCloseDialogProc);
procedure MessageDlg(const AMessage: string; const ADialogType: TMsgDlgType; const AButtons: TMsgDlgButtons;
const AHelpContext: THelpContext; const ADefaultButton: TMsgDlgBtn; const ACloseDialogEvent: TInputCloseDialogEvent;
const AContext: TObject);
C++
extern DELPHI_PACKAGE int __fastcall MessageDlg _DEPRECATED_ATTRIBUTE1("Use FMX.DialogService methods") (const System::UnicodeString AMessage, const System::Uitypes::TMsgDlgType ADialogType, const System::Uitypes::TMsgDlgButtons AButtons, const System::Classes::THelpContext AHelpContext)/* overload */;
Inhaltsverzeichnis
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
function | public | FMX.Dialogs.pas FMX.Dialogs.hpp |
FMX.Dialogs | FMX.Dialogs |
Beschreibung
Warnung: MessageDlg ist veraltet. Bitte verwenden Sie Platform.IFMXDialogServiceAsync.MessageDialogAsync.
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:
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 |
OS X | Blockierend | Blockierend |
iOS | Blockierend | Nicht blockierend |
Android | Nicht blockierend |