formatTest

Controla la validación contra la cláusula de formato de visualización.

La propiedad formatTest se puede utilizar para las validaciones. La propiedad formatTest no se evalúa en los campos nulos. La propiedad formatTest puede ser un contexto evaluado durante la vida de un formulario, como cuando un campo deja de estar activo.

Para diferenciar entre nullTest y scriptTest, utilice formatTest para comprobar el valor del campo en cuestión. Si es nulo o está vacío, la validación habrá fallado como resultado de una validación nullTest.

Sintaxis

Reference_Syntax.formatTest = "warning | disabled | error"

Valores

Tipo

Valores

Cadena

  • desactivado

  • error

  • warning (predeterminado)

  • dismiss: el usuario comprende el mensaje y desea regresar al formulario para cumplir esta restricción.

  • override: el usuario comprende el mensaje pero decide contravenir esta restricción.

No se realiza ninguna prueba. El objeto de formulario está permitido para tener un valor que no esté conforme a una cláusula de formato. El campo se puede dejar con un valor que no esté conforme y no invalidará el formulario.

  • error

  • warning (predeterminado)

  • dismiss: el usuario comprende el mensaje y desea regresar al formulario para cumplir esta restricción.

  • override: el usuario comprende el mensaje pero decide contravenir esta restricción.

Emite un mensaje y no acepta datos que no se adapten a la cláusula de formato. El objeto de formulario debe adecuarse a un formato de imagen.

  • warning (predeterminado)

  • dismiss: el usuario comprende el mensaje y desea regresar al formulario para cumplir esta restricción.

  • override: el usuario comprende el mensaje pero decide contravenir esta restricción.

Emite un mensaje si los datos no se ajustan a la cláusula de formato, pero permite que el usuario vaya al campo siguiente. El mensaje debe informar al usuario de que el objeto de formulario debería tener un valor que está conforme con la cláusula de formato. Debe proporcionar dos opciones:

  • dismiss: el usuario comprende el mensaje y desea regresar al formulario para cumplir esta restricción.

  • override: el usuario comprende el mensaje pero decide contravenir esta restricción.

Aplicable a

Versión

XFA 2,1

Ejemplos

Define el patrón de validación si no se ha definido ya.

JavaScript

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

FormCalc

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