FMX.Dialogs.InputBox
Delphi
function InputBox(const ACaption, APrompt, ADefault: string): string;
procedure InputBox(const ACaption, APrompt, ADefault: string; const ACloseBoxProc: TInputCloseBoxProc);
procedure InputBox(const ACaption, APrompt, ADefault: string; const ACloseBoxEvent: TInputCloseBoxEvent; const AContext: TObject);
C++
extern DELPHI_PACKAGE System::UnicodeString __fastcall InputBox _DEPRECATED_ATTRIBUTE1("Use FMX.DialogService methods") (const System::UnicodeString ACaption, const System::UnicodeString APrompt, const System::UnicodeString ADefault)/* overload */;
Inhaltsverzeichnis
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
function | public | FMX.Dialogs.pas FMX.Dialogs.hpp |
FMX.Dialogs | FMX.Dialogs |
Beschreibung
Warnung: InputBox ist veraltet. Bitte verwenden Sie IFMXDialogServiceAsync.InputQueryAsync oder IFMXDialogServiceSync.InputQuerySync aus der Unit FMX.Platform.
Zeigt ein Dialogfeld für die Eingabe von Text an.
InputBox erhält die folgenden Parameter:
ACaption
repräsentiert den Titel des Dialogfeldes.APrompt
repräsentiert die Beschriftung links neben dem TEdit.ADefault
repräsentiert den Standardtext des TEdit.ACloseBoxProc
(optional) ist eine anonyme Methode, die beim Schließen des Dialogfeldes von InputBox ausgeführt wird.
Wenn der Benutzer auf die Schaltfläche OK klickt, gibt InputBox den in das Steuerelement TEdit des Dialogfeldes eingegebenen Text zurück. Wenn der Benutzer auf die Schaltfläche Abbrechen klickt, gibt InputBox den Wert des Parameters ADefault
zurück. Wenn Sie den Parameter ACloseBoxProc
angeben, gibt InputBox keinen Wert zurück; das an die Methode ACloseBoxProc
übergebene Argument AValue
enthält stattdessen die Benutzereingabe.
Wenn im Aufruf von InputBox der Parameter ACloseBoxProc
nicht enthalten ist, wird der Aufruf auf allen Plattformen blockiert; d. h., InputBox kehrt erst zurück, wenn das Dialogfeld geschlossen wird. Android unterstützt keine blockierenden Aufrufe; Sie können InputBox unter Android nur verwenden, wenn Sie den Parameter ACloseBoxProc
angeben.
Aufrufe von InputBox, die den Parameter ACloseBoxProc
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 InputBox 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 ACloseBoxProc
von InputBox, 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 InputBox auf der jeweiligen Plattform und ob diese Aufrufe blockierend oder nicht blockierend sind:
Plattform | Ohne ACloseBoxProc
|
Mit ACloseBoxProc
|
---|---|---|
Windows | Blockierend | Blockierend |
OS X | Blockierend | Blockierend |
iOS | Blockierend | Nicht blockierend |
Android | Nicht blockierend |