FMX.Platform.IFMXDialogServiceAsync.InputQueryAsync

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure InputQueryAsync(const ACaption: string; const APrompts: array of string; const ADefaultValues: array of string;
const ACloseDialogProc: TInputCloseQueryProc); overload;
procedure InputQueryAsync(const ACaption: string; const APrompts: array of string; const ADefaultValues: array of string;
const ACloseQueryEvent: TInputCloseQueryWithResultEvent; const AContext: TObject = nil); overload;

C++

virtual void __fastcall InputQueryAsync(const System::UnicodeString ACaption, const System::UnicodeString *APrompts, const int APrompts_High, const System::UnicodeString *ADefaultValues, const int ADefaultValues_High, const Fmx::Dialogs::_di_TInputCloseQueryProc ACloseDialogProc) = 0 /* overload */;
virtual void __fastcall InputQueryAsync(const System::UnicodeString ACaption, const System::UnicodeString *APrompts, const int APrompts_High, const System::UnicodeString *ADefaultValues, const int ADefaultValues_High, const Fmx::Dialogs::TInputCloseQueryWithResultEvent ACloseQueryEvent, System::TObject* const AContext = (System::TObject*)(0x0)) = 0 /* overload */;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
FMX.Platform.pas
FMX.Platform.hpp
FMX.Platform IFMXDialogServiceAsync


Beschreibung

Zeigt ein Dialogfeld an, das Texteingabefelder und eine OK-Schaltfläche enthält.

InputQueryAsync arbeitet asynchron. Aufrufe von InputQueryAsync werden unmittelbar beendet, sie warten nicht bis der Benutzer das Dialogfeld geschlossen hat. Verwenden Sie IFMXDialogServiceSync.InputQuerySync, um synchron zu arbeiten.

InputQueryAsync erhält die folgenden Parameter:

  • ACaption ist der Titel des Dialogfeldes.
  • APrompts ist ein String-Array zur Verwendung als Beschriftungen auf der linken Seite der Texteingabefelder.
  • ADefaultValues ist ein String-Array, das Vorgabewerte für Felder definiert.
    Hinweis: ADefaultValues muss länger oder gleich lang wie APrompts sein.
  • ACloseDialogProc oder ACloseQueryEvent ist eine anonyme Methode oder Ereignisbehandlungsroutine, die aufgerufen wird, nachdem der Benutzer das Dialogfeld geschlossen und die Benutzereingabe erhält hat.
  • AContext ist ein optionales Objekt, das Sie als Kontext für die ACloseQueryEvent zugewiesene Ereignisbehandlungsroutine bereitstellen können.

Wenn der Benutzer das Dialogfeld schließt, ruft InputQueryAsync die angegebene anonyme Methode oder Ereignisbehandlungsroutine mit den folgenden Argumenten auf:

  • Sender (nur ACloseQueryEvent) enthält den angegebenen Parameter AContext.
  • AResult ist der Wert der Schaltfläche für modale Ergebnisse zum Schließen des Dialogfeldes.
  • AValues enthält die Strings, die der Benutzer in die Texteingabefelder des Dialogfeldes eingegeben hat.

Verwenden Sie stattdessen TDialogServiceAsync.InputQuery, um InputQueryAsync aufzurufen, ohne dass eine Instanz von IFMXDialogServiceAsync erforderlich ist.


Maskieren des Inhalts eines Texteingabefeldes

Um den Inhalt eines Texteingabefeldes zu maskieren, so dass während dem Tippen Punkte anstatt Zeichen angezeigt werden, geben Sie ein Steuerzeichen für den Beginn der Kopfzeile (start of heading, SOH) (EN) am Anfang des entsprechendes Beschriftung-Strings des APrompts an. Zum Beispiel:

  • Delphi: #1'Password:'
  • C++: "\1Password:"


Plattformunterstütztung

Plattform Unterstützung
Windows
YesC++11Feature.png
OS X
YesC++11Feature.png
iOS
YesC++11Feature.png
Android
YesC++11Feature.png


Siehe auch