Ett objekts förekomstvärde

Hakparentesen ([ ]) anger ett objekts förekomstvärde.

I språkspecifika formulär för arabiska, hebreiska, thailändska och vietnamesiska finns referenssyntaxen alltid till höger (även för språk som skrivs från höger till vänster).

Beteckning

[ ]

Exempel

Du refererar till ett förekomstvärde genom att sätta hakparentes ([ ]) efter ett objektnamn. Något av följande värden måste finnas i hakparentesen:

  • [ n ], där n är förekomstens indexnummer som ett absolut tal räknat från 0. Förekomstnummer utanför intervallet returnerar inget värde. Exempel:

    xfa.form.form1.#subform.Quantity[3]

    refererar till den fjärde förekomsten av objektet Quantity.

  • [ +/- n ], där n anger en förekomst i förhållande till förekomsten av objektet som gör referensen. Positiva värden ger högre förekomstnummer medan negativa värden ger lägre. Exempel:

    xfa.form.form1.#subform.Quantity[+2]

    Den här referensen avser den förekomst av Quantity vars förekomstnummer är två högre än den refererande behållarens förekomstnummer. Om det t ex var objektet Quantity[2] som gjorde referensen skulle den vara likvärdig med att skriva

    xfa.template.Quantity[4]

    Om det framräknade indexnumret ligger utanför intervallet returnerar referensen ett fel.

    Syntaxen används oftast för att hitta föregående eller nästa förekomst av ett visst objekt. Alla förekomster av objektet utom den första kan t ex använda Quantity för att få värdet för föregående Quantity-objekt.

  • [*] indikerar flera förekomster av ett objekt. Det första namngivna objektet hittas och objekt med samma namn på samma nivå returneras. Observera att om du använder det här skrivsättet returneras en objektsamling. Exempel:

    xfa.form.form1.#subform.Quantity[*]

  • Det här uttrycket refererar till alla objekt med namnet Quantity som finns på samma nivå som den första förekomsten av Quantity som referensen påträffar.

Visa grafik i full storlek

Givet exempelträdet ovan returnerar uttrycken följande objekt:

  • Subform_Page.Subform1[*] returnerar båda Subform1-objekten.

  • Subform_Page.Subform1.Subform3.TextField2[*] returnerar två TextField2-objekt.Subform_Page.Subform1 leder till det första Subform1-objektet till vänster och TextField2[*] utvärderas i förhållande till Subform3-objektet.

  • Subform_Page.Subform1[*].TextField1 returnerar båda TextField1-förekomsterna.Subform_Page.Subform1[*] leder till båda Subform1-objekten och TextField1 utvärderas i förhållande till Subform1-objekten.

  • Subform_Page.Subform1[*].Subform3.TextField2[1] returnerar det andra och det fjärde TextField2-objektet från vänster.Subform_Page.Subform1[*] leder till båda Subform1 -objekten och TextField2[1] utvärderas i förhållande till Subform3-objekten.

  • Subform_Page.Subform1[*].Subform3[*] returnerar båda TextField1-objekten.

  • Subform_Page.*returnerar både Subform1-objekten och Subform2-objektet.

  • Subform_Page.Subform2.*returnerar de två förekomsterna av NumericField2-objektet.

  • Du kan använda syntaxen ”[ ]” (hakparentes) med JavaScript om det används med metoden resolveNode.