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, et TextField2[*] est évalué relativement à l’objet Subform3 .
Subform_Page.Subform1[*].TextField1 renvoie les deux instances TextField1 . Subform_Page.Subform1[*] a pour résultat les deux objets Subform1 , et TextField1 est évalué relativement aux objets Subform1 .
Subform_Page.Subform1[*].Subform3.TextField2[1] renvoie le deuxième et le quatrième objets TextField2 à partir de la gauche. Subform_Page.Subform1[*] a pour résultat les deux objets Subform1 , et TextField2[1] est évalué relativement aux objets Subform3 .
Subform_Page.Subform1[*].Subform3[*] renvoie les deux instance de l’objet Subform3 .
Subform_Page.* renvoie les deux objets Subform1 et l’objet Subform2 .
Subform_Page.Subform2.* renvoie les deux instances de l’objet NumericField2 .
L’utilisation des crochets ([ ]) est admise dans le langage JavaScript avec la méthode resolveNode .