activity

Specifica il nome dell'evento.

La proprietà ref associata deve specificare un oggetto che può generare l'evento denominato.

Sintassi

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

Valori

Tipo

Valore

Stringa

change

Si verifica quando un utente esegue un'azione, ad esempio incolla del testo. Di seguito sono presentati ulteriori esempi di azioni che attivano un evento change:

  • Con ciascun tasto

  • Quando il testo viene incollato

  • Quando si seleziona una nuova opzione

  • Quando si seleziona una casella di controllo

  • Quando si seleziona un elemento

 

click (predefinito)

Si verifica quando l'utente fa clic nel campo. La maggior parte dei sistemi definisce il clic come la pressione e il rilascio del pulsante del mouse senza spostare il puntatore oltre un limite minimo.

 

docClose 

Viene eseguito al termine dell'elaborazione di un modulo, solo se tutte le convalide vengono terminate senza errori. Questo evento si verifica troppo tardi per modificare un documento salvato. Il suo scopo è quello di fornire l'abilità di generare uno stato di uscita o un messaggio di completamento.

 

docReady 

Viene eseguito prima del rendering del documento, ma dopo il binding dei dati.

 

enter 

Relativamente a un campo, si verifica quando il campo diventa attivo. Relativamente a un sottomodulo o a un gruppo di esclusione, si verifica quando qualche campo all'interno del sottomodulo o del gruppo di esclusione diventa attivo, vale a dire quando lo stato attivo si sposta dall'esterno all'interno dell'oggetto.

 

enter 

Relativamente a un campo, si verifica quando il campo diventa attivo. Relativamente a un sottomodulo o a un gruppo di esclusione, si verifica quando qualche campo all'interno del sottomodulo o del gruppo di esclusione diventa attivo, vale a dire quando lo stato attivo si sposta dall'esterno all'interno dell'oggetto.

 

exit 

Relativamente a un campo, si verifica quando il campo diventa inattivo. Relativamente a un sottomodulo o a un gruppo di esclusione, si verifica quando tutti i campi all'interno del sottomodulo o del gruppo di esclusione diventano inattivi, vale a dire quando lo stato attivo si sposta dall'interno all'esterno dell'oggetto.

 

full 

Si avvia quando un compilatore del modulo tenta di immettere più del contenuto massimo consentito nel campo.

 

initialize 

Viene eseguito al termine del binding dei dati. Viene generato un evento separato per ogni istanza del sottomodulo nel modello modulo.

 

mouseDown 

Si verifica quando l'utente preme il pulsante del mouse nel campo, tuttavia prima che il pulsante venga rilasciato.

 

mouseEnter 

Si verifica quando l'utente trascina il puntatore sul campo senza necessariamente premere il pulsante.

 

mouseExit 

Si verifica quando l'utente trascina il puntatore all'esterno del campo senza necessariamente premere il pulsante.

 

mouseUp 

Si verifica quando l'utente rilascia il pulsante del mouse nel campo.

 

postExecute 

Si verifica quando i dati sono stati inviati a un servizio Web tramite WSDL, subito dopo è stata ricevuta la risposta alla richiesta ed è stato eseguito il marshalling sui dati ricevuti in un oggetto connectionData sotto $datasets. Uno script avviato da questo evento consente di esaminare ed elaborare i dati ricevuti. Al termine dell'esecuzione di questo evento, i dati ricevuti vengono eliminati.

 

postPrint 

Si verifica immediatamente dopo che il modulo, al termine del rendering, viene inviato alla stampante, allo spooler o alla destinazione di output.

 

postSave 

Si verifica immediatamente dopo che il modulo è stato scritto in formato PDF o in formato XDP. Non si verifica quando il modello dati o altri sottoinsiemi del modulo vengono esportati in XDP.

 

preExecute 

Si verifica quando una richiesta viene inviata a un servizio Web tramite WSDL. Uno script avviato da questo evento consente di esaminare e modificare i dati prima dell'invio della richiesta. Se lo script è contrassegnato in modo da essere eseguito solo nel server, i dati vengono inviati al server indicando che deve eseguire lo script associato prima delle altre elaborazioni.

 

preSave 

Si verifica immediatamente prima che i dati del modulo siano scritti in formato PDF o in formato XDP. Non si verifica quando il modello dati o altri sottoinsiemi del modulo vengono esportati in XDP. L'elaborazione conclusiva XSLT, se attivata, si verifica al termine di questo evento.

 

preSubmit 

Si verifica quando i dati vengono inviati all'host tramite il protocollo HTTP. Uno script avviato da questo evento consente di esaminare e modificare i dati prima dell'invio. Se lo script è contrassegnato in modo da essere eseguito nel server, i dati vengono inviati al server indicando che deve eseguire lo script associato prima delle altre elaborazioni.

 

ready 

Si verifica quando il modello ha terminato il caricamento.

 

validationState

Viene attivato in corrispondenza della modifica dello stato relativo a un campo, un sottomodulo o un gruppo di esclusione. La modifica dello stato di convalida corrisponde al passaggio da una condizione di validità a una di non validità o alla modifica della verifica che ha generato lo stato non valido.

L'evento ha lo scopo di modificare l'aspetto dei campi in base al relativo stato di validità o non validità.

La proprietà event.target viene composta con l'oggetto contenitore il cui stato di convalida ha subito modifiche.

La proprietà event.name viene composta con il nome dell'attività (validationState).

Quando viene inizializzato un gruppo di esclusione o un sottomodulo, l'evento validationState viene attivato subito dopo l'evento initialize relativo all'oggetto specificato.

È prevista una nuova attivazione dell'evento solo in corrispondenza di una modifica dello stato di convalida. Tuttavia, è consigliabile strutturare la logica del modulo in modo da consentire l'attivazione dell'evento anche se non si verificano modifiche dello stato di convalida.

L'evento validationState viene attivato solo dopo che l'esame dello stato di verifica di tutti gli oggetti inclusi nell'operazione di convalida è stato completato.

Per stabilire se l'oggetto di destinazione dell'evento è valido, verificare se è presente un valore relativo alla proprietà $event.target.errorText.

Si applica a

Modello

Oggetto

Modello Modulo

event

Versione

XFA 2.1

Esempi

JavaScript

TextField1.event.activity = "mouseEnter";

FormCalc

TextField1.event.activity = "mouseEnter"