Durante la creazione di calcoli e script, è necessario associare ogni voce a un evento di modulo specifico. Ogni evento di modulo rappresenta una modifica nello stato del modulo che viene eseguita in un momento specifico.
La modifica dello stato del modulo può avvenire durante l'esecuzione del rendering del modulo sul server, da parte di Foms, oppure sul client, da parte di Acrobat o Adobe Reader, mentre l'utente compila il modulo.
Quando viene eseguita una modifica nello stato del modulo, i calcoli o script associati all'evento vengono elaborati automaticamente.
L'evento utilizzato durante la creazione di un calcolo o script in una certa misura determinerà cosa includere nel calcolo o script. Ad esempio, la quantità e il tipo di informazioni disponibili in un modulo possono variare a seconda dei tempi dell'evento scelti; pertanto, un calcolo o uno script che recupera un valore da un campo può avere risultati diversi se eseguito prima o dopo l'esecuzione di certe azioni da parte del compilatore. Per ulteriori informazioni sugli eventi, vedere Eventi.
A seconda del tipo di modulo creato, alcuni eventi potrebbero non verificarsi mai. Ad esempio, se si crea un modulo con un layout fisso e nessun oggetto interattivo, gli eventi interattivi associati alle azioni del compilatore non si verificano mai e, di conseguenza, tutti gli script associati a tali eventi non verranno mai eseguiti.
Sebbene Designer supporti un'ampia varietà di eventi di modulo, è possibile che esso esegua molte comuni operazioni di calcolo e scripting utilizzando solo pochi eventi che si verificano in occasione delle principali modifiche allo stato di un modulo, come i seguenti eventi:
- docReady
- Viene eseguito immediatamente dopo l'apertura del modulo in Acrobat o Adobe Reader e subito prima che il compilatore inizi a interagire con gli oggetti del modulo. Quest'evento è l'ultimo che si verifica prima che il controllo del modulo venga assegnato al compilatore.
- enter
- È eseguito quando il compilatore apporta modifiche allo stato attivo di un determinato campo, pulsante o sottomodulo.
- exit
- È eseguito quando il compilatore trasferisce lo stato attivo da un determinato campo, pulsante o sottomodulo a un altro oggetto.
- change
- È eseguito quando un compilatore apporta una modifica al valore di un campo. Quest'evento viene utilizzato soprattutto con gli elenchi a discesa e le caselle di riepilogo, per eseguire uno script quando un compilatore apporta una modifica al valore corrente.
- click
- È eseguito quando un compilatore fa clic su un campo o su un pulsante. Quest'evento viene utilizzato soprattutto con i pulsanti per eseguire uno script quando un compilatore fa clic sul pulsante.
