FMX.Dialogs.InputBox

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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 */;

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

Siehe auch