activity

Indique le nom de l’événement.

La propriété ref associée doit spécifier un objet pouvant générer l’événement nommé.

Syntaxe

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

Valeurs

Type

Valeur

Chaîne

change

Se produit lorsque l’utilisateur exécute une action, telle que le collage de texte. Voici d’autres exemples d’actions qui déclenchent l’événement de modification :

  • Lors de chaque frappe de touche

  • Lorsque le texte est collé

  • Lorsqu’une nouvelle sélection est effectuée

  • Lors de la sélection d’une case à cocher

  • Lors de la sélection d’un élément

 

click (par défaut)

Se produit lorsque l’utilisateur clique dans le champ. Sur la plupart des systèmes, un clic représente l’action d’appuyer sur le bouton de la souris et de le relâcher en déplaçant le pointeur le moins possible.

 

docClose 

Cet événement est exécuté à chaque fin de formulaire, si et seulement si toutes les validations de formulaire se sont terminées sans erreur. Lorsque cet événement se déclenche, vous ne pouvez plus modifier un document enregistré, l’objectif étant de donner la possibilité de générer un état « quitter » ou un message d’accomplissement.

 

docReady 

Cet événement est exécuté avant que le document ne soit rendu, mais après la liaison de données.

 

enter 

Pour un champ, cet événement se déclenche lorsque le champ atteint la cible d’action du clavier. Pour un sous-formulaire ou un groupe d’exclusion, cet événement se déclenche lorsqu’un champ du sous-formulaire ou du groupe d’exclusion atteint la cible d’action du clavier, c’est-à-dire lorsque la cible d’action du clavier se déplace de l’extérieur vers l’intérieur de l’objet.

 

enter 

Pour un champ, cet événement se déclenche lorsque le champ atteint la cible d’action du clavier. Pour un sous-formulaire ou un groupe d’exclusion, cet événement se déclenche lorsqu’un champ du sous-formulaire ou du groupe d’exclusion atteint la cible d’action du clavier, c’est-à-dire lorsque la cible d’action du clavier se déplace de l’extérieur vers l’intérieur de l’objet.

 

exit 

Pour un champ, cet événement se déclenche lorsque le champ n’est plus contrôlé par la cible d’action du clavier. Pour un sous-formulaire ou un groupe d’exclusion, cet événement se déclenche lorsque l’ensemble des champs du sous-formulaire ou du groupe d’exclusion n’est plus contrôlé par la cible d’action du clavier, c’est-à-dire lorsque la cible d’action se déplace de l’intérieur vers l’extérieur de l’objet.

 

full 

Cet événement se déclenche lorsque l’utilisateur tente de saisir le contenu maximum autorisé dans un champ.

 

initialize 

Cet événement est exécuté une fois la liaison de données terminée. Un événement séparé est généré pour chaque instance du sous-formulaire dans le modèle de formulaire.

 

mouseDown 

Se produit lorsque l’utilisateur appuie sur le bouton de la souris dans le champ, mais avant que ce dernier ne soit relâché.

 

mouseEnter 

Se produit lorsque l’utilisateur fait glisser le pointeur sur le champ sans nécessairement appuyer sur le bouton.

 

mouseExit 

Se produit lorsque l’utilisateur fait glisser le pointeur hors du champ sans nécessairement appuyer sur le bouton.

 

mouseUp 

Se produit lorsque l’utilisateur relâche le bouton de la souris dans le champ.

 

postExecute 

Se produit lorsque des données sont envoyées vers un service Web via WSDL, juste après réception de la réponse à la requête et après que les données reçues ont été classées dans un objet connectionData sous $datasets. Un script déclenché par cet événement peut consulter et traiter les données reçues. Une fois cet événement exécuté, les données reçues sont effacées.

 

postPrint 

Cet événement se produit juste après que le formulaire rendu a été envoyé à l’imprimante, au programme d’impression différée ou à la destination de sortie.

 

postSave 

Cet événement se produit juste après que le formulaire été enregistré au format PDF ou XDP. Cet événement ne se produit pas si le modèle de données ou un autre sous-ensemble du formulaire est exporté au format XDP.

 

preExecute 

Se produit lorsqu’une requête est envoyée à un service Web via WSDL. Un script déclenché par cet événement peut consulter et modifier les données avant l’envoi de la requête. Si le script est défini de sorte à être exécuté uniquement sur le serveur, les données sont envoyées au serveur avec l’instruction d’exécuter le script associé avant tout autre traitement.

 

preSave 

Se produit juste après que les données du formulaire ont été enregistrées au format PDF ou XDP. Cet événement ne se produit pas si le modèle de données ou un autre sous-ensemble du formulaire est exporté au format XDP. Le post-traitement XSLT, s’il est activé, a lieu après cet événement.

 

preSubmit 

Se produit lorsque des données sont envoyées à l’hôte via le protocole HTTP. Un script déclenché par cet événement peut consulter et modifier les données avant leur envoi. Si le script est défini de sorte à être exécuté sur le serveur, les données sont envoyées au serveur avec l’instruction d’exécuter le script associé avant tout autre traitement.

 

ready 

Se produit lorsque le chargement du modèle est terminé.

 

validationState

Se déclenche lorsque l’état de validation d’un champ, sous-formulaire ou groupe d’exclusion change. L’état de validation change lors du passage de l’état valide à l’état non valide, ou lorsque le test ayant provoqué l’état non valide change.

L’utilisation de l’événement vise à modifier l’apparence des champs lorsqu’ils deviennent valides ou non valides.

L’événement.La propriété target est remplie avec l’objet conteneur dont l’état de validation a changé.

La propriété event.name est remplie avec le nom de l’activité validationState.

Lorsqu’un champ, un groupe d’exclusion ou un sous-formulaire est initialisé, l’événement validationState se déclenche immédiatement après l’événementinitialize correspondant à cet objet.

L’événement ne doit se déclencher à nouveau que lorsque l’état de validation change. Cependant, la logique du formulaire doit être suffisamment robuste pour permettre à l’événement de se déclencher, même si l’état de validation n’a pas réellement changé.

L’événement validationState ne se déclenche qu’après l’évaluation de l’état de validation pour tous les objets inclus dans l’opération de validation.

Vous pouvez déterminer si l’événement cible est valide en vérifiant si la propriété $event.target.errorText possède une valeur.

Application

Version

XFA 2.1

Exemples

JavaScript

TextField1.event.activity = "mouseEnter";

FormCalc

TextField1.event.activity = "mouseEnter"