formatTest

Controla a validação com base na cláusula de imagem de exibição.

A propriedade formatTest pode ser usada para validações. A propriedade formatTest não é avaliada em campos nulos. A propriedade formatTest pode ser um contexto avaliado durante o tempo de vida de um formulário, tal como quando o foco sai de um campo.

Para diferenciar entre nullTest e scriptTest, use formatTest para verificar o valor do campo em questão. Se ele for nulo ou vazio, a validação falhará como resultado de uma validação nullTest.

Sintaxe

Reference_Syntax.formatTest = "warning | disabled | error"

Valores

Tipo

Valores

String

  • desativado

  • erro

  • warning (padrão)

  • dismiss: O usuário entende a mensagem e deseja voltar ao formulário para atender a essa restrição.

  • override: O usuário entende a mensagem, mas opta por transgredir essa restrição.

Não realizar testes. O objeto de formulário pode ter um valor que não esteja em conformidade com a cláusula de imagem. O campo pode ser deixado com um valor não conforme, e o formulário não será invalidado.

  • erro

  • warning (padrão)

  • dismiss: O usuário entende a mensagem e deseja voltar ao formulário para atender a essa restrição.

  • override: O usuário entende a mensagem, mas opta por transgredir essa restrição.

Emite uma mensagem e não aceita dados que não correspondam à cláusula de imagem. O objeto de formulário deve estar em conformidade com uma cláusula de imagem.

  • warning (padrão)

  • dismiss: O usuário entende a mensagem e deseja voltar ao formulário para atender a essa restrição.

  • override: O usuário entende a mensagem, mas opta por transgredir essa restrição.

Emitirá uma mensagem se os dados não corresponderem à cláusula de imagem, mas permitirá que o usuário prossiga para o campo seguinte. A mensagem deve informar o usuário se o objeto de formulário deve ter um valor em conformidade com a cláusula de imagem. Devem ser oferecidas duas opções:

  • dismiss: O usuário entende a mensagem e deseja voltar ao formulário para atender a essa restrição.

  • override: O usuário entende a mensagem, mas opta por transgredir essa restrição.

Aplica-se a

Modelo

Objeto

Modelo de formulário

validate

Versão

XFA 2.1

Exemplos

Define o padrão de validação se esse padrão ainda não foi definido.

JavaScript

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

FormCalc

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