Valore occorrenza di un oggetto

La notazione parentesi quadra ([ ]) indica il valore occorrenza di un oggetto.

Nei moduli specifici per le lingue araba, ebraica, tailandese e vietnamita, la sintassi di riferimento si trova sempre a destra. Ciò vale anche per le lingue che si scrivono da destra a sinistra.

Notazione

[ ]

Esempio

Per creare un riferimento al valore occorrenza, posizionare le parentesi quadre ([ ]) dopo un nome oggetto e racchiudere tra parentesi uno dei seguenti valori:

[ n ], dove n è un numero di indice di occorrenza assoluto che inizia in corrispondenza di 0. Un numero di occorrenza non compreso nell'intervallo restituisce un errore. Ad esempio,
```
xfa.form.form1.#subform.Quantity[3]
```
si riferisce alla quarta occorrenza dell'oggetto Quantity.
[ +/- n ], dove n indica una occorrenza relativa alla occorrenza dell'oggetto che costituisce il riferimento. Valori positivi producono numeri di occorrenza più alti mentre valori negativi producono numeri di occorrenza più bassi. Ad esempio,
```
xfa.form.form1.#subform.Quantity[+2]
```
Questo riferimento genera l'occorrenza dell'oggetto Quantity, il cui valore numerico è superiore di due rispetto al numero di occorrenza del contenitore che costituisce il riferimento. Ad esempio, se allegato all'oggetto Quantity[2], il riferimento è lo stesso di
```
xfa.template.Quantity[4]
```
Se il numero di indice calcolato non rientra nell'intervallo, il riferimento genera un errore.

Questa sintassi è utilizzata generalmente per individuare l'occorrenza precedente o successiva di uno specifico oggetto. Ad esempio, ogni occorrenza dell'oggetto Quantity (ad eccezione della prima) potrebbe utilizzare Quantity per restituire il valore dell'oggetto Quantity precedente.
[*] indica più occorrenze di un oggetto. Una volta trovato il primo oggetto denominato, vengono restituiti gli oggetti con lo stesso nome e lo stesso livello del primo. Utilizzando questa notazione si ottiene un insieme di oggetti. Ad esempio,
```
xfa.form.form1.#subform.Quantity[*]
```
Questa espressione fa riferimento a tutti gli oggetti con un nome Quantity allo stesso livello della prima occorrenza dell'oggetto Quantity trovato dal riferimento.

Visualizzazione dell’elemento grafico a dimensioni intere

Utilizzando la struttura come riferimento, queste espressioni restituiscono i seguenti oggetti:

Subform_Page.Subform1[*] restituisce entrambi gli oggetti Subform1.
Subform_Page.Subform1.Subform3.TextField2[*] restituisce due oggetti TextField2.Subform_Page.Subform1 restituisce il primo oggetto Subform1 a sinistra e TextField2[*] risulta relativo all'oggetto Subform3.
Subform_Page.Subform1[*].TextField1 restituisce entrambe le istanze TextField1.Subform_Page.Subform1[*] restituisce entrambi gli oggetti Subform1 e TextField1 risulta relativo agli oggetti Subform1.
Subform_Page.Subform1[*].Subform3.TextField2[1] restituisce il secondo e il quarto oggetto TextField2 da sinistra.Subform_Page.Subform1[*] restituisce entrambi gli oggetti Subform1 e TextField2[1] risulta relativo agli oggetti Subform3.
Subform_Page.Subform1[*].Subform3[*] restituisce entrambe le istanze dell'oggetto Subform3.
Subform_Page.*restituisce sia l'oggetto Subform1 che l'oggetto Subform2.
Subform_Page.Subform2.*restituisce le due istanze dell'oggetto NumericField2.
È possibile inserire le parentesi quadre ‘ [ ]' all'interno di codice JavaScript, purché siano utilizzate assieme al metodo resolveNode.