Objekte in Berechnungen und Skripten referenzieren

FormCalc-Berechnungen und JavaScript-Skripten unterliegen bei der Strukturierung von Code zwar jeweils spezifischen Regeln, aber wenn es um den Zugriff auf Formularobjekteigenschaften und -werte geht, stützen sie sich auf die gleiche Referenz-Syntax. Das XML-Formularobjektmodell bietet über eine Namenskonvention, bei der alle Objekte, Eigenschaften und Methoden jeweils durch ein Punktzeichen (.) voneinander getrennt sind, eine strukturierte Möglichkeit, auf Objekteigenschaften und -werte zuzugreifen.

Jede Referenzsyntax weist in der Regel eine in folgende Abschnitte unterteilte Struktur auf:

  • Die Namen der übergeordneten Objekte in der Formularhierarchie, die zur Navigation zu einem bestimmten Feld oder Objekt dient. Mit den beiden Paletten „Hierarchie“ und „Datenansicht“ können Sie die Position eines Objekts im Verhältnis zu anderen Objekten im Formular und in zugehörigen Daten ermitteln.

  • Der Name des Objekts, das Sie referenzieren möchten.

  • Der Name der Eigenschaft oder Methode, auf die Sie zugreifen möchten. Dieser Abschnitt enthält möglicherweise auch Objekte des XML-Formularobjektmodells, die in der Struktur vor der Eigenschaft oder Methode auftreten, aber in der Palette „Hierarchie“ nicht als Objekte aufgeführt werden.

In der folgenden Abbildung sehen Sie die Referenz-Syntax für den Zugriff auf den Wert eines Textfelds in einem Formularentwurf. Dabei gelten die folgenden Konventionen für die Objektbenennung:

A.
Formularhierarchie-Objekte

B.
Objektname

C.
Name der Eigenschaft oder Methode

Hinweis: Das Teilformularobjekt, welches die erste Seite eines neuen Formulars darstellt, ist standardmäßig unbenannt. In der obigen Referenzsyntax wird das unbenannte Teilformular als #subform bezeichnet.

Die Notationsstruktur der Referenz-Syntax hängt immer von der spezifischen Situation ab. Beispielsweise ist eine vollständig qualifizierte Referenz-Syntax für alle Situationen geeignet. In einigen Fällen können Sie die Syntax aber durch eine verkürzte Referenz-Syntax oder einen Referenz-Syntax-Kurzbefehl etwas übersichtlicher gestalten.