Voorvalwaarde van een object

Met de rechte haken ([ ]) verwijst u naar de voorvalwaarde van een object.

In taalspecifieke formulieren voor Arabisch, Hebreeuws, Thais en Vietnamees bevindt de verwijzingssyntaxis zich altijd aan de rechterkant (zelfs voor talen die van rechts naar links worden geschreven).

Notatie

[ ]

Voorbeeld

Als u een verwijzing naar een voorvalwaarde wilt opnemen, plaatst u rechte haken ([ ]) achter de naam van een object en plaatst u een van de volgende waarden binnen de haken:

[ n ], waarbij n een absoluut voorvalindexnummer is dat begint bij 0. Als een voorvalwaarde wordt gebruikt die buiten het bereik valt, wordt geen waarde geretourneerd. Bijvoorbeeld,
```
xfa.form.form1.#subform.Quantity[3]
```
verwijst naar het vierde exemplaar van het object Quantity.
[ +/- n ], waarbij n naar een exemplaar verwijst dat voor of na het object valt dat de verwijzing maakt. Een positieve waarde geeft een hogere voorvalwaarde en een negatieve waarde geeft een lagere voorvalwaarde. Bijvoorbeeld,
```
xfa.form.form1.#subform.Quantity[+2]
```
Met deze verwijzing haalt u het exemplaar op van Quantity dat een indexnummer heeft dat twee hoger is dan het indexnummer van de container die de verwijzing maakt. Als deze verwijzing bijvoorbeeld is gekoppeld aan het object Quantity[2], is de verwijzing gelijk aan
```
xfa.template.Quantity[4]
```
Als het berekende indexnummer buiten het bereik valt, wordt een fout geretourneerd door de verwijzing.

Deze syntaxis wordt het meest gebruikt om te zoeken naar het vorige of volgende exemplaar van een bepaald object. Zo kunt u voor elk exemplaar van het object Quantity (behalve het eerste) met Quantity[-1] de waarde van het vorige Quantity-object ophalen.
[*] verwijst naar meerdere exemplaren van een object. Het eerste genoemde object wordt gevonden en de objecten met dezelfde naam die gelijksoortige versies van het eerste object zijn, worden in het resultaat opgenomen. Met deze notatie wordt een verzameling objecten geretourneerd. Bijvoorbeeld,
```
xfa.form.form1.#subform.Quantity[*]
```
Met deze expressie wordt verwezen naar alle objecten met de naam Quantity die gelijksoortige versies zijn van het eerste exemplaar van Quantity dat door de verwijzing wordt aangetroffen.

Afbeelding groot weergeven

Met de verwijzingenstructuur worden de volgende objecten door deze expressies geretourneerd:

Met Subform_Page.Subform1[*] worden beide Subform1-objecten geretourneerd.
Met Subform_Page.Subform1.Subform3.TextField2[*] worden twee TextField2-objecten geretourneerd.Subform_Page.Subform1 resulteert in het eerste Subform1-object aan de linkerkant en TextField2[*] wordt verwerkt in relatie tot het object Subform3.
Met Subform_Page.Subform1[*].TextField1 worden beide TextField1-instanties geretourneerd.Subform_Page.Subform1[*] resulteert in beide Subform1-objecten en TextField1 wordt verwerkt in relatie tot de Subform1-objecten.
Met Subform_Page.Subform1[*].Subform3.TextField2[1] wordt het tweede en vierde TextField2-object vanaf de linkerkant geretourneerd.Subform_Page.Subform1[*] resulteert in beide Subform1-objecten en TextField2[1] wordt verwerkt in relatie tot de Subform3-objecten.
Met Subform_Page.Subform1[*].Subform3[*] worden beide instanties van het object Subform3 geretourneerd.
Subform_Page.Met * worden beide Subform1-objecten en het object Subform2 geretourneerd.
Subform_Page.Subform2.Met * worden de twee exemplaren van het object NumericField2 geretourneerd.
U kunt de syntaxis met ‘[ ]’ (vierkante haken) gebruiken in JavaScript als u deze gebruikt met de methode resolveNode.