validate, suceso

Descripción

Se inicia cuando se combinan el diseño y los datos para crear un formulario y cuando un campo deja de estar activo; por ejemplo, cuando el usuario que rellena el formulario hace clic o utiliza el tabulador para salir de un campo. Este suceso se inicia de nuevo cada vez que cambia el valor de un campo. Los cálculos y las secuencias de comandos asociados con el suceso validate proporcionan un método para realizar validaciones más específicas que las que están disponibles en la ficha Valor de la paleta Objeto.

Los cálculos y las secuencias de comandos del suceso validate deben devolver true o false (expresados de forma adecuada para el lenguaje de la secuencia de comandos) según si la validación es correcta o falla, y no deben afectar a la estructura ni a los valores generales del formulario. Además, no deben intentar ofrecer comentarios al usuario que rellena el formulario, ya que es posible que el usuario no esté utilizando el formulario en una aplicación cliente como Acrobat.

Nota: dado que las validaciones se realizan en relación con el contenido del formulario, no se pueden usar para verificar el formato de la presentación derivado de los patrones de campo.

Tipo

Suceso de proceso

Compatibilidad

Aplicación cliente

Disponibilidad

Acrobat y Adobe Reader

yes

Explorador HTML

yes

Versión

XFA 2,1

Ejemplo

Se puede utilizar este suceso para verificar valores de objeto, especialmente en situaciones en las que los datos de los objetos se deban ajustar a reglas específicas. Por ejemplo, se puede crear una secuencia de comandos en el suceso validate para verificar que un campo de coste total de una orden de compra no tenga un valor negativo.

Para ver un ejemplo detallado del uso del suceso validate, consulte Definición de un campo como requerido en tiempo de ejecución.