Valeur d’occurrence d’un objet

Les crochets ([ ]) représentent la valeur d’occurrence d’un objet.

dans les formulaires en arabe, hébreu, thaï et vietnamien, la syntaxe de référence se trouve toujours à droite (même pour les langues s’écrivant de droite à gauche).

Notation

[ ]

Exemple

Pour créer une référence à une valeur d’occurrence, placez des crochets ([ ]) après un nom d’objet et insérez entre les crochets l’une des valeurs suivantes :

[ n ], où n est un numéro d’index d’occurrence absolu commençant à 0. Un numéro d’occurrence hors limite ne renvoie aucune valeur Par exemple :
```
xfa.form.form1.#subform.Quantity[3]
```
renvoie à la quatrième occurrence de l’objet Quantity.
[ +/- n ], où n indique une occurrence relative à l’occurrence de l’objet porteur de la référence. Les valeurs positives retournent des nombres d’occurrences plus élevés alors que les valeurs négatives retournent des nombres d’occurrences plus bas. Par exemple :
```
xfa.form.form1.#subform.Quantity[+2]
```
Cette référence retourne l’occurrence de Quantity dont le nombre d’occurrences est deux de plus que le nombre d’occurrences du conteneur qui constitue la référence. Si, par exemple, cette référence était jointe à l’objet Quantity[2], la référence serait la même que :
```
xfa.template.Quantity[4]
```
Si le numéro d’index calculé est hors limite, la référence renvoie une erreur.

Cette syntaxe sert surtout à localiser l’occurrence précédente ou suivante d’un objet en particulier. Par exemple, chaque occurrence de l’objet Quantity (sauf la première) peut utiliser Quantity[-1] pour obtenir la valeur de l’objet Quantity précédent.
[*] indique plusieurs occurrences d’un objet. Le premier objet nommé est trouvé, et les objets portant le même nom et ayant le même parent immédiat sont retournés. Le résultat de cette notation est une collection d’objets. Par exemple :
```
xfa.form.form1.#subform.Quantity[*]
```
Cette expression fait référence à tous les objets portant le nom de Quantity et ayant le même parent immédiat que la première occurrence de Quantity trouvée par la référence.

Afficher le graphique en taille réelle

L’arborescence servant de référence, les expressions suivantes retournent les résultats indiqués :

Subform_Page.Subform1[*] renvoie les deux objets Subform1.
Subform_Page.Subform1.Subform3.TextField2[*] renvoie deux objets TextField2.Subform_Page.Subform1 a pour résultat le premier objet Subform1 sur la gauche, etTextField2[*]est évalué relativement à l’objetSubform3.
Subform_Page.Subform1[*].TextField1 renvoie les deux instancesTextField1.Subform_Page.Subform1[*]a pour résultat les deux objetsSubform1, etTextField1est évalué relativement aux objetsSubform1.
Subform_Page.Subform1[*].Subform3.TextField2[1]renvoie le deuxième et le quatrième objetsTextField2à partir de la gauche.Subform_Page.Subform1[*]a pour résultat les deux objetsSubform1, etTextField2[1]est évalué relativement aux objetsSubform3.
Subform_Page.Subform1[*].Subform3[*]renvoie les deux instance de l’objetSubform3.
Subform_Page.*renvoie les deux objetsSubform1et l’objetSubform2.
Subform_Page.Subform2.*renvoie les deux instances de l’objetNumericField2.
L’utilisation des crochets ([ ]) est admise dans le langage JavaScript avec la méthode resolveNode .