Valor de ocorrência de um objeto

A notação de colchetes ([ ]) indica o valor de ocorrência de um objeto.

Em formulários específicos para os idiomas arábico, hebraico, tailandês e vietnamita, a sintaxe de referência está sempre à direita (mesmo para idiomas lidos da direita para a esquerda).

Notação

[ ]

Exemplo

Para construir uma referência de valor de ocorrência, coloque colchetes ([ ]) após o nome de um objeto e coloque um dos seguintes valores entre parênteses:

[ n ], em que n corresponde a um número absoluto de índice de ocorrência que começa em 0. Um número de ocorrência fora do intervalo não retorna um valor. Por exemplo,
```
xfa.form.form1.#subform.Quantity[3]
```
refere-se à quarta ocorrência do objeto Quantity.
[ +/- n ], em que n indica uma ocorrência relativa à ocorrência do objeto que faz a referência. Os valores positivos geram números de ocorrência mais altos e os valores negativos geram números de ocorrência mais baixos. Por exemplo,
```
xfa.form.form1.#subform.Quantity[+2]
```
Essa referência gera a ocorrência de Quantity, cujo número de ocorrência é duas vezes maior que o número de ocorrência do contêiner que faz a referência. Por exemplo, se essa referência tivesse sido anexada ao objeto Quantity[2], a referência seria igual a
```
xfa.template.Quantity[4]
```
Se o número de índice calculado estiver fora do intervalo, a referência retornará um erro.

Essa sintaxe é usada com mais frequência para localizar ocorrências anteriores ou posteriores de um objeto específico. Por exemplo, toda ocorrência do objeto Quantity (exceto a primeira) deve usar Quantity[-1] para obter o valor do objeto Quantity anterior.
[*] indica várias ocorrências de um objeto. O primeiro objeto nomeado é localizado, e os objetos com o mesmo nome, que são irmãos do primeiro, são retornados. Observe que essa notação é retornada em uma coleta de objetos. Por exemplo,
```
xfa.form.form1.#subform.Quantity[*]
```
Essa expressão refere-se a todos os objetos com o nome Quantity que são irmãos da primeira ocorrência de Quantity encontrado pela referência.

Visualizar gráfico inteiro

Usando a árvore como referência, essas expressões retornam os seguintes objetos:

Subform_Page.Subform1[*] retorna os dois objetos Subform1.
Subform_Page.Subform1.Subform3.TextField2[*] retorna dois objetos TextField2.Subform_Page.Subform1 resolve o primeiro objeto Subform1 à esquerda e TextField2[*] avalia em relação ao objeto Subform3 .
Subform_Page.Subform1[*].TextField1 retorna as duas instâncias de TextField1.Subform_Page.Subform1[*] resolve os dois objetos Subform1 e TextField1 avalia em relação aos objetos Subform1 .
Subform_Page.Subform1[*].Subform3.TextField2[1] retorna o segundo e o quarto objetos TextField2 da esquerda.Subform_Page.Subform1[*] resolve os dois objetos Subform1 e TextField2[1] avalia em relação aos objetos Subform3 .
Subform_Page.Subform1[*].Subform3[*] retorna as duas instâncias do objeto Subform3.
Subform_Page.*retorna os dois objetos Subform1 e o objeto Subform2.
Subform_Page.Subform2.*retorna as duas instâncias do objeto NumericField2.
Você pode usar a sintaxe ‘ [ ]’ (colchetes) com o JavaScript, se ela for usada com o método resolveNode.