formatTest

Steuert die Überprüfung auf Übereinstimmung mit der Anzeigen-Picture-Klausel.

Die formatTest-Eigenschaft kann für Überprüfungen verwendet werden. Die formatTest-Eigenschaft wird für Null-Felder nicht ausgewertet. Die formatTest-Eigenschaft kann während der Lebensdauer eines Formulars ein ausgewerteter Kontext sein (z. B. wenn ein Feld den Fokus verliert).

Um zwischen nullTest und scriptTest zu unterscheiden, verwenden Sie formatTest zum Prüfen des Werts im jeweiligen Feld. Ist der Wert null oder ist das Feld leer, schlägt die Überprüfung infolge einer nullTest-Überprüfung fehl.

Syntax

Reference_Syntax.formatTest = "warning | disabled | error"

Werte

Typ

Werte

Zeichenfolge

  • deaktiviert

  • Fehler

  • warning (Standard)

  • dismiss: Der Benutzer nimmt die Meldung zur Kenntnis und möchte zum Formular zurückkehren, um diese Einschränkung zu erfüllen.

  • override: Der Benutzer nimmt die Meldung zur Kenntnis, entscheidet jedoch, gegen diese Einschränkung zu verstoßen

Keinen Test ausführen. Das Formularobjekt darf einen Wert haben, welcher der Picture-Klausel nicht entspricht. Selbst wenn das Feld einen nicht konformen Wert enthält, wird das Formular dadurch nicht ungültig.

  • Fehler

  • warning (Standard)

  • dismiss: Der Benutzer nimmt die Meldung zur Kenntnis und möchte zum Formular zurückkehren, um diese Einschränkung zu erfüllen.

  • override: Der Benutzer nimmt die Meldung zur Kenntnis, entscheidet jedoch, gegen diese Einschränkung zu verstoßen

Eine Meldung wird ausgegeben, und es werden keine Daten akzeptiert, die nicht mit der Picture-Klausel übereinstimmen. Das Formularobjekt muss einer Picture-Klausel entsprechen.

  • warning (Standard)

  • dismiss: Der Benutzer nimmt die Meldung zur Kenntnis und möchte zum Formular zurückkehren, um diese Einschränkung zu erfüllen.

  • override: Der Benutzer nimmt die Meldung zur Kenntnis, entscheidet jedoch, gegen diese Einschränkung zu verstoßen

Wenn die Daten nicht mit der Picture-Klausel übereinstimmen, wird eine Meldung ausgegeben. Der Benutzer darf jedoch zum nächsten Feld wechseln. Die Meldung muss den Benutzer darüber informieren, dass das Formularobjekt einen Wert haben sollte, welcher der Picture-Klausel entspricht. Es müssen zwei Möglichkeiten zur Verfügung stehen:

  • dismiss: Der Benutzer nimmt die Meldung zur Kenntnis und möchte zum Formular zurückkehren, um diese Einschränkung zu erfüllen.

  • override: Der Benutzer nimmt die Meldung zur Kenntnis, entscheidet jedoch, gegen diese Einschränkung zu verstoßen

Gilt für

Modell

Objekt

Formularmodell

validate

Version

XFA 2.1

Beispiele

Überprüfungsmuster festlegen, wenn dieses noch nicht definiert wurde.

JavaScript

TextField1.validate.picture.value = "A9A 9A9"; 
TextField1.validate.formatTest = "error";

FormCalc

TextField1.validate.picture = "A9A 9A9" 
TextField1.validate.formatTest = "error"