Sammlungen
Statt der Methode
Item können Sie auf Elemente einer Sammlung mithilfe von runden oder eckigen Klammern zugreifen. Die verfügbare Syntax hängt von der Sprache ab:
Verwenden Sie beispielsweise
Items( 1 ).Text = "Hello" oder Items[ 1 ].Text = "Hello". Alle Sammlungen können in for each- und ähnlichen Konstrukten verwendet werden.
Wiederkehrende Felder und Tabellen
Items-Sammlung.
Ein Prototypfeld hat weder untergeordnete Elemente noch einen Wert. Es speichert lediglich die Iterationen des Felds. Untergeordnete Felder und Feldwerte sind nur in den Feldinstanzen vorhanden, auf die Sie über die Methode Items des Objekts IField zugreifen.
Tabellen verfügen immer über die Sammlung Rows (Rows ist ein Synonym für Items). Die Sammlung Rows enthält nur Tabellenzeilen, deren Zellen Sie über die Methode Children der Zeilen aufrufen können.
Die Methoden Field, HasField und IndexedItemValue des IDocument-Objekts verwenden Pfade zu den Feldern im Formular als Parameter. Die folgende Backus-Naur-Form (BNF) definiert die Syntax dieser Pfade:
Field_name die Namen der Dokumentfelder, wie sie in der Document Definition definiert sind, und Field_iteration_number die Iterationsnummer des wiederkehrenden Felds (bei Tabellen die Zeilennummer), beginnend bei 0.
Der Pfad kann absolut oder relativ sein. Ein absoluter Pfad beginnt mit dem Namen des Dokumentabschnitts. Ein relativer Pfad beginnt mit dem Namen des untergeordneten Elements in der Gruppe.
Um beispielsweise die dritte Zeile der Spalte Total in der Tabelle Table im Abschnitt Section zu adressieren, schreiben Sie "Section\Table[2]\Total". Sie können diesen vollständigen Namen mit der Methode FullName des Objekts IField erstellen.