Referera till objektegenskap och värde

Referenssyntaxen som du använder för att använda eller modifiera objektegenskaper och värden har en av följande former:

Fullständig
Referenssyntaxen inkluderar den fullständiga objekthierarkin, och börjar med rotnoden xfa. Den fullständiga syntaxen använder objektets egenskap eller värde korrekt oavsett var beräkningen eller skriptet med referenssyntaxen finns.

Förkortad
Referenssyntaxen kan förkortas antingen om beräkningen eller skriptet med referenssyntaxen och objektsyntaxreferenserna har en relativ placering, eller om kortkommandon används. Som regel gäller att även om det går snabbare att skapa en förkortad referenssyntax är nackdelen att den bara fungerar under förutsättning att objekten alltid finns på samma plats i förhållande till varandra.

I denna bild visas hierarkin för ett enkelt beställningsformulär.

I denna bild visas en fullständig referenssyntax för FormCalc och JavaScript för användning av värdet i txtCondition fältet. Denna referenssyntax kan användas som en del av en beräkning eller skript för valfritt objekt i formuläret.

A.
Rotnod

B.
Modell

C.
Rotnod för formulärdesign

D.
Sidobjekt

E.
Namn på delformulär

F.
Objektnamn

G.
Egenskaps- eller metodnamn

Obs! Även om referenssyntaxen är gemensam för FormCalc och JavaScript måste du iaktta konventionerna för de båda skriptspråken. Referenssyntaxen i ovanstående exempel fungerar t ex för FormCalc; för JavaScript måste däremot ett avslutande semikolon (;) läggas till.

Om två objekt finns i samma behållare, t ex ett delformulär, så kan de dela samma kontext. När flera objekt finns i samma kontext kan du använda en förkortad referenssyntax som bara inkluderar namnet på objektet, följt av den egenskap eller metod som du vill använda. I ovanstående exempel använder följande förkortade referenssyntax värdet i fältet txtCondition från valfritt fält i delformuläret total :

    txtCondition.rawValue

Om två objekt finns i olika behållare delar de inte samma kontext. I detta fall kan du använda en förkortad referenssyntax. Syntaxen måste emellertid inledas med namnet på behållarobjektet på den översta nivån som de två objekten inte har gemensamt. I ovanstående hierarki används följande förkortade referenssyntax värdet för fältet address från fältet txtCondition :

    header.address.rawValue

På grund av strukturen i XML-formulärobjektmodellen återfinns vissa objektegenskaper och metoder i formulärobjektens underordnade objekt. Dessa underordnade objekt ingår endast i XML-formulärobjektmodellen, och visas inte på paletterna Hierarki och Datavy. Dessa egenskaper och metoder kan användas endast om de underordnade objekten inkluderas i referenssyntaxen. Följande referenssyntax specificerar t ex funktionsbeskrivningen för fältet txtCondition :

    txtCondition.assist.toolTip.value = "Conditions of purchase."  // FormCalc 
    txtCondition.assist.toolTip.value = "Conditions of purchase."; // JavaScript

Mer information om XML-formulärsobjektmodellens objekt och deras struktur finns i Skriptreferens.