Valor de incidencia de un objeto

La notación de corchetes ([ ]) denota el valor de incidencia de un objeto.

En formularios específicos de idiomas para árabe, hebreo, tailandés y vietnamita, la sintaxis de referencia se encuentra siempre a la derecha (incluso para los idiomas que se leen de derecha a izquierda).

Notación

[ ]

Ejemplo

Para crear una referencia de valor de incidencia, utilice corchetes ([ ]) detrás de un nombre de objeto y encierre entre corchetes uno de los valores siguientes:

[ n ], donde n es un número de índice de incidencia absoluto que empieza en 0. Un número de incidencia fuera de rango no devuelve un valor. Por ejemplo:
```
xfa.form.form1.#subform.Quantity[3]
```
refers to the fourth occurrence of the Quantity object.
[ +/- n ], donde n indica una incidencia relativa a la incidencia del objeto que hace la referencia. Con valores positivos se obtienen números de incidencia mayores, mientras que con los negativos se obtienen números de incidencia menores. Por ejemplo:
```
xfa.form.form1.#subform.Quantity[+2]
```
Esta referencia da como resultado la incidencia de Quantity cuyo número de incidencia es dos números mayor que el número de incidencias del contenedor que hace la referencia. Por ejemplo, si esta referencia se adjunta al objeto Quantity[2], la referencia equivaldría a:
```
xfa.template.Quantity[4]
```
Si el número de índice computado está fuera de rango, la referencia genera un error.

Esta sintaxis se emplea habitualmente para ubicar la incidencia anterior o siguiente de un objeto concreto. Por ejemplo, todas las incidencias del objeto Quantity (salvo la primera) pueden utilizar Quantity[-1] para obtener el valor del objeto Quantity anterior.
[*] indica varias incidencias de un objeto. Se encuentra el primer objeto nombrado y se devuelven los objetos que tengan el mismo nombre y sean descendientes del primero. Tenga en cuenta que cuando se usa esta notación se obtiene un conjunto de objetos. Por ejemplo:
```
xfa.form.form1.#subform.Quantity[*]
```
Esta expresión se refiere a todos los objetos con el nombre de Quantity que sean descendientes de la primera incidencia del objeto Quantity encontrada.

Ver gráfico a tamaño completo

Con el árbol como referencia, las expresiones devuelven los siguientes objetos:

Subform_Page.Subform1[*] devuelve ambos objetos Subform1.
Subform_Page.Subform1.Subform3.TextField2[*] devuelve dos objetos TextField2.Subform_Page.Subform1 se resuelve en el primero objeto Subform1 de la izquierda y TextField2[*] se evalúa en relación con el objeto Subform3.
Subform_Page.Subform1[*].TextField1 devuelve las dos instancias de TextField1.Subform_Page.Subform1[*] se resuelve en los dos objetos Subform1 y TextField1 se evalúa en relación con los objetos Subform1.
Subform_Page.Subform1[*].Subform3.TextField2[1] devuelve el segundo y el cuarto objeto TextField2 de la izquierda.Subform_Page.Subform1[*] se resuelve en los dos objetos Subform1 y TextField2[1] se evalúa en relación con los objetos Subform3.
Subform_Page.Subform1[*].Subform3[*] devuelve las dos instancias del objeto Subform3.
Subform_Page.*devuelve los dos objetos Subform1 y el objeto Subform2.
Subform_Page.Subform2.*devuelve las dos instancias del objeto NumericField2.
Es posible utilizar la sintaxis ‘ [ ]’ (corchetes) con JavaScript si se utiliza con el método resolveNode.