FMX.Platform.IFMXDialogServiceAsync.InputQueryAsync

De RAD Studio API Documentation
Aller à : navigation, rechercher

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

Propriétés

Type Visibilité  Source Unité  Parent
procedure
function
public
FMX.Platform.pas
FMX.Platform.hpp
FMX.Platform IFMXDialogServiceAsync


Description

Affiche une boîte de dialogue contenant des champs de saisie de texte et un bouton OK.

InputQueryAsync fonctionne de façon asynchrone. Les appels à InputQueryAsync se terminent instantanément, ils n'attendent pas à ce que l'utilisateur ferme la boîte de dialogue. Pour un fonctionnement synchrone, utilisez IFMXDialogServiceSync.InputQuerySync.

InputQueryAsync reçoit les paramètres suivants :

  • ACaption est le titre de la boîte de dialogue.
  • APrompts est un tableau de chaînes à utiliser en tant que libellés sur le côté gauche des champs de saisie de texte.
  • ADefaultValues est un tableau de chaînes qui définissent les valeurs par défaut pour les champs.
    Remarque : La longueur de AValues doit être supérieure ou égale à la longueur de APrompts.
  • ACloseDialogProc ou ACloseQueryEvent est une méthode anonyme ou un gestionnaire d'événement appelé après que l'utilisateur ferme la boîte de dialogue et reçoit la saisie de texte.
  • AContext est un objet optionnel que vous pouvez fournir comme contexte pour le gestionnaire d'événement assigné à ACloseQueryEvent.

Quand l'utilisateur ferme la boîte de dialogue, InputQueryAsync appelle la méthode anonyme ou le gestionnaire d'événement spécifié avec les arguments suivants :

  • Sender (ACloseQueryEvent uniquement) contient le AContext spécifié.
  • AResult est la valeur de résultat modal du bouton utilisé pour fermer la boîte de dialogue.
  • AValues contient les chaînes que l'utilisateur a saisies dans les champs de saisie de texte de la boîte de dialogue.

Pour appeler InputQueryAsync sans nécessiter une instance de IFMXDialogServiceAsync, utilisez TDialogServiceAsync.InputQuery à la place.


Masquage du contenu d'un champ de saisie de texte

Pour masquer le contenu d'un champ de saisie de texte, pour que, lorsque vous tapez, des points sont affichés et non des caractères, incluez un caractère de contrôle (début d'en-tête (SOH, start of heading) au début de la chaîne de libellé depuis APrompts. Par exemple :

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


Prise en charge des plates-formes

Plate-forme Prise en charge
Windows
YesC++11Feature.png
OS X
YesC++11Feature.png
iOS
YesC++11Feature.png
Android
YesC++11Feature.png


Voir aussi