FMX.Edit.TCustomEdit.OnValidating

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property OnValidating: TValidateTextEvent read GetOnValidating write SetOnValidating;

C++

__property Fmx::Text::TValidateTextEvent OnValidating = {read=GetOnValidating, write=SetOnValidating};

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
event public
FMX.Edit.pas
FMX.Edit.hpp
FMX.Edit TCustomEdit


Beschreibung

Wird ausgelöst, wenn Sie Symbole eingeben oder der Fokus vom Eingabefeld entfernt wird.

Mit einer OnValidating-Ereignisbehandlungsroutine können Sie, während der Benutzer Informationen in das Eingabefeld eingibt, diese sofort überprüfen. Mit der Ereignisbehandlungsroutine OnValidating kann der eingegebene Text überprüft werden. Wird der Text nicht akzeptiert, wird eine Fehlermeldung oder Warnung zurückgegeben.

Beispiel

Sehen Sie sich zur Klärung das folgende Szenario an: Eine Anwendung enthält ein Eingabefeld zur Eingabe einer E-Mail-Adresse. Wenn der Benutzer ein Leerzeichen oder den Teilstring "@." eingibt, zeigt die Behandlungsroutine OnValidating ein Ausrufezeichen-Symbol neben dem Eingabefeld an. Dieses Symbol teilt dem Benutzer mit, dass die aktuellen Symbole für die E-Mail-Adresse nicht zulässig sind.

Hinweis: Zuerst ist das Ausrufezeichen unsichtbar. Die Ereignisbehandlungsroutine OnValidating setzt die Eigenschaft TImage.Visible auf True, wenn ein Eingabefehler auftritt.

OnValidating.png

Für dieses Szenario können Sie die folgenden OnValidating-Ereignisbehandlungsroutinen implementieren:

Delphi:
procedure TForm1.Edit1Validating(Sender: TObject; var Text: string);
begin
  Image1.Visible := Text.Contains(' ') or Text.Contains('@.');
end;
C++Builder:
void __fastcall TForm1::Edit1Validating(TObject *Sender, UnicodeString &Text) {
	Image1->Visible = ContainsStr(Text, " ") || ContainsStr(Text, "@.");
}

Hinweis: Zur Verarbeitung der Benutzereingabe wird in diesen Codefragmenten Folgendes verwendet:

Siehe auch