activity

Especifica el nombre del suceso.

La propiedad ref adjunta debe especificar un objeto que pueda generar el suceso.

Sintaxis

Reference_Syntax.activity = "change | click | docClose | docReady | enter | exit | full | initialize | mouseDown | mouseEnter | mouseExit | mouseUp | postExecute | postPrint | postSave | preExecute | prePrint | preSave | preSubmit | ready | validationState"

Valores

Tipo

Value

Cadena

change

Se produce cuando el usuario ejecuta una acción, como pegar texto. A continuación se enumeran más ejemplos de acciones que desencadenan un suceso Change:

  • Con cada pulsación de teclas.

  • Cuando se pega texto.

  • Cuando se selecciona una nueva opción.

  • Cuando se selecciona una casilla de verificación

  • Cuando se selecciona un elemento

 

click (predeterminado)

Se produce cuando el usuario hace clic en el campo. La mayoría de los sistemas definen la propiedad click al pulsar y soltar el botón del ratón sin desplazar el puntero más allá de una mínima distancia.

 

docClose 

Se ejecuta al final del proceso de un formulario si, y sólo si, todas las validaciones del formulario se completan sin errores. Este suceso llega demasiado tarde para modificar un documento guardado. El propósito es tener la capacidad de generar un mensaje de estado completado o de estado de salida.

 

docReady 

Se ejecuta antes del procesamiento de un documento, pero después del enlace de los datos.

 

enter 

En un campo, se produce cuando el campo se activa para el uso del teclado. En un subformulario o en un grupo de exclusión, se produce cuando algún campo del subformulario o del grupo de exclusión se activa para el uso del teclado, es decir, la selección del teclado pasa de estar fuera del objeto a estar dentro.

 

enter 

En un campo, se produce cuando el campo se activa para el uso del teclado. En un subformulario o en un grupo de exclusión, se produce cuando algún campo del subformulario o del grupo de exclusión se activa para el uso del teclado, es decir, la selección del teclado pasa de estar fuera del objeto a estar dentro.

 

exit 

En un campo, se produce cuando el campo se desactiva para el uso del teclado. En un subformulario o en un grupo de exclusión, se produce cuando todos los campos del subformulario o del grupo de exclusión se desactivan para el uso del teclado, es decir, la selección pasa de estar dentro del objeto a estar fuera.

 

full 

Se inicia cuando el usuario que rellena el formulario intenta superar la cantidad máxima de contenido permitida en un campo.

 

initialize 

Se ejecuta una vez finalizado el enlace de datos. Se genera un suceso independiente para cada instancia del subformulario en el modelo de formulario.

 

mouseDown 

Se produce cuando el usuario pulsa el botón del ratón en el campo, antes de soltarlo.

 

mouseEnter 

Se produce cuando el usuario arrastra el puntero sobre un campo sin pulsar necesariamente el botón.

 

mouseExit 

Se produce cuando el usuario arrastra el puntero fuera de un campo sin pulsar necesariamente el botón.

 

mouseUp 

Se produce cuando el usuario suelta el botón del ratón en el campo.

 

postExecute 

Se produce cuando se envían datos a un servicio Web mediante WSDL, justo después de recibir la respuesta a la solicitud y de reunir los datos recibidos en un objeto connectionData bajo $datasets. Una secuencia de comandos desencadenada por este suceso puede examinar y procesar los datos recibidos. Tras la ejecución del suceso, se eliminan los datos recibidos.

 

postPrint 

Se produce justo después de que el formulario procesado se envíe a la impresora, a la cola de impresión o a un destino de salida.

 

postSave 

Se produce justo después de que el formulario se haya escrito en formato PDF o XDP. No se produce cuando se exporta a XDP el modelo de datos o cualquier otro subconjunto del formulario.

 

preExecute 

Se produce cuando se envía una solicitud a un servicio Web mediante WSDL. Una secuencia de comandos desencadenada por este suceso puede examinar y modificar los datos antes de enviar la solicitud. Si la secuencia de comandos está marcada para su ejecución únicamente en el servidor, los datos se envían al servidor con la orden de ejecutar la secuencia de comandos asociada antes de realizar el resto del proceso.

 

preSave 

Se produce justo antes de que los datos de formulario se hayan escrito en formato PDF o XDP. No se produce cuando se exporta a XDP el modelo de datos o cualquier otro subconjunto del formulario. El postprocesado XSLT (si está activado) se produce después de este suceso.

 

preSubmit 

Se produce cuando se envían los datos al host mediante el protocolo HTTP. Una secuencia de comandos desencadenada por este suceso puede examinar y modificar los datos antes de enviarlos. Si la secuencia de comandos está marcada para su ejecución en el servidor, los datos se envían al servidor con la orden de ejecutar la secuencia de comandos asociada antes de realizar el resto del proceso.

 

ready 

Se produce cuando el modelo ha terminado de cargarse.

 

validationState

Se activa cuando el estado de validación de un campo, subformulario o grupo de exclusión cambia. Se considera que el estado de validación cambia cuando pasa de válido a no válido, o viceversa, o cuando la prueba que activó el estado no válido cambia.

El uso intencionado del suceso es cambiar el aspecto de los campos cuando pasan al estado válido o no válido.

La propiedad event.target se llena con el objeto contenedor cuyo estado de validación haya cambiado.

La propiedad event.name se rellena con el nombre de la actividad (validationState).

Cuando se inicializa un campo, un grupo de exclusión o un subformulario, el suceso validationState se activa inmediatamente tras el suceso initialize de ese objeto.

El suceso se activa de nuevo sólo cuando el estado de validación cambia. Sin embargo, la lógica del formulario debería ser lo suficientemente robusta como para permitir que el suceso se active incluso aunque el estado de validación no haya cambiado.

El suceso validationState sólo se activa después de que se haya evaluado el estado de validación de todos los objetos incluidos en la operación de validación.

Se puede determinar si el destino del suceso es válido comprobando si la propiedad $event.target.errorText tiene un valor.

Aplicable a

Versión

XFA 2,1

Ejemplos

JavaScript

TextField1.event.activity = "mouseEnter";

FormCalc

TextField1.event.activity = "mouseEnter"