Skriptunterstützung für HTML5-Formulare

15. Juli 2024

Themen:

Erstellt für:

Admin
Benutzende
Entwickler

Die folgenden JavaScript, FormCalc-Eigenschaften und Methoden werden in HTML5-Formularen unterstützt:

$event

Eigenschaft	Beschreibung	Ausnahme
`prevText`	Gibt den Inhalt des Felds vor einer Änderung aufgrund von Benutzeraktionen an. Dieser Wert kann ähnlich wie bei einer Rückgängig-Funktion erneut aufgerufen werden.	Er funktioniert nicht mit Dropdown-Menüs und Listenfeldern. `PrevText` funktioniert in folgenden Fällen nicht: Beim Eingeben von bestimmten Sonderzeichen (z. B. $ oder , oder & oder @) in ein numerisches Feld auf einem iPad und Im Datumsfeld (wenn das Datum über den Kalender eingetragen wird). Das Festlegen eines Werts mithilfe eines Skripts wird nicht unterstützt.
`target`	Gibt das Objekt an, für das das Ereignis ausgeführt wird.	Das Festlegen eines Werts mithilfe eines Skripts wird nicht unterstützt.
`newtext`	Gibt den Inhalt des Feldes nach einer Änderung aufgrund von Benutzeraktionen an.	Die Eigenschaft `newText` funktioniert in folgenden Fällen nicht ordnungsgemäß: Beim Markieren und Ersetzen von Texten Beim Löschen, Kopieren und Einfügen von Texten Beim Eingeben von bestimmten Sonderzeichen (z. B. $ oder , oder & oder @) in numerische Felder Beim Verwenden der Kombination Umschalttaste+alphanumerisches Zeichen. Beim Verwenden von Datums- und Uhrzeitfeldern Das Festlegen eines Werts mithilfe eines Skripts wird nicht unterstützt.
ändern	Gibt den Wert an, den Sie unmittelbar nach der Durchführung der Aktion in ein Feld eingeben oder einfügen.	Die Eigenschaft „Ändern“ funktioniert in folgenden Fällen nicht ordnungsgemäß: Beim Markieren und Ersetzen von Texten Beim Löschen, Kopieren und Einfügen von Texten Beim Eingeben von bestimmten Sonderzeichen (z. B. $ oder , oder & oder @) in numerische Felder Beim Verwenden der Kombination Umschalttaste+alphanumerisches Zeichen. Beim Verwenden von Datums- und Uhrzeitfeldern Das Festlegen eines Werts mithilfe eines Skripts wird nicht unterstützt.
keyDown	Stellt fest, ob Benutzende die Auswahl durch Drücken einer Pfeiltaste treffen. Diese Eigenschaft ist nur für Listenfelder und Dropdown-Listen verfügbar.	Ohne
modifier	Legt fest, ob bei Ausführung eines bestimmten Ereignisses die Modifizierungstaste (beispielsweise Strg unter Microsoft® Windows®) gedrückt wird.	Ohne

$host

Eigenschaft	Beschreibung	Ausnahme
`apptype`	Gibt den Anwendungstyp des Hosts zurück. Nur für Client-Anwendungen verfügbar.	Rückgabe `HTML 5`.
`name`	Gibt den Namen der aktuellen Anwendung zurück.	Gibt den Browsernamen und die Version zurück. Beim Browser Chrome wird beispielsweise folgender Wert zurückgegeben: `Chrome <version>.`
`numPages`	Gibt die Anzahl der Seiten im Dokument zurück.	Die Paginierungsrichtlinie in HTML5-Formularen unterscheidet sich von der entsprechenden Richtlinie in PDF-Formularen. Die numPages-API gibt daher in den beiden Fällen eventuell unterschiedliche Werte zurück.
`platform`	Gibt eine Zeichenfolge zurück, die für die Plattform des Computers steht, auf dem das Skript ausgeführt wird.	Ohne
`title`	Gibt den Titel des Dokuments an. Nur für Client-Anwendungen verfügbar.	Gibt nicht wie im Fall von PDF-Formularen den Metadatentitel des Formulars, sondern den Titel des HTML-Dokuments im Formular zurück.
`version`	Gibt eine Zeichenfolge zurück, die die Versionsnummer der aktuellen Anwendung darstellt.	Gibt die Version des Formulars zurück.
`calculationsEnabled`	Gibt an, ob Berechnungsskripte ausgeführt werden.	Ohne
`validationsEnabled`	Gibt an, ob Überprüfungsskripte ausgeführt werden.	Ohne
`pageUp`	Wechselt zur vorherigen Seite.	HTML5-Formulare folgen nicht derselben Paginierungsrichtlinie wie PDF-Formulare. Daher unterscheidet sich die vorherige Seite eines HTML5-Formulars von der vorherigen Seite eines PDF-Formulars.
`pageDown`	Wechselt zur nächsten Seite eines Formulars. Verwendet die pageDown-Methode zur Laufzeit.
`setFocus`	Stellt den Tastaturfokus auf das angegebene Feld ein. Das Feld wird als Objekt oder durch den SOM-Ausdruck des Felds definiert. Nur für Client-Anwendungen verfügbar.
`resetdata`	Setzt die Felder auf ihre Standardwerte in einem Dokument zurück.	Löscht alle Daten in einem Formular mit zusammengeführten Daten, anstatt die Standardwerte wiederherzustellen.
`messageBox`	Zeigt ein Dialogfeld auf dem Bildschirm an. Nur für Client-Anwendungen verfügbar.	Das Meldungsfeld vom Typ „Ja/Nein“ wird in ein Feld vom Typ „OK/Abbrechen“ konvertiert. Ein Meldungsfeld mit drei Schaltflächen wird nicht unterstützt.
currentPage	Legt die aktuell aktive Seite eines Dokuments zur Laufzeit fest. Seitenzahlen sind 0-basiert, d. h., die erste Seite eines Dokuments gibt den Wert 0 zurück. Die currentPage-Eigenschaft ist verfügbar, wenn „layout:ready“ auf einem Client ausgeführt wird. Sie ist jedoch nicht verfügbar, wenn „layout:ready“ auf dem Server ausgeführt wird, da die Eigenschaft nur in Verbindung mit dem Formular-Layout ausgeführt wird.	Ohne

field

Eigenschaft	Beschreibung	Ausnahme
`presence`	Steuert die Teilnahme des zugehörigen Objekts in den verschiedenen Phasen der Verarbeitung. Wenn das Objekt ein Container ist, werden alle Einschränkungen dieses Steuerelements für den Inhalt des Containers übernommen.	Ohne
`access`	Steuert den Benutzerzugriff auf den Inhalt.	Funktioniert nicht mit die Ausschlussgruppe. Außerdem werden nicht interaktive und geschützte Objekte in HTML5-Formularen auf dieselbe Weise behandelt.
`name`	Eine Kennung, die verwendet wird, um dieses Element in Skriptausdrücken eindeutig zu kennzeichnen.	In HTML5-Formulare kann die Eigenschaft „name“ nicht für Objekte festgelegt werden. Es handelt sich um eine schreibgeschützte Eigenschaft für HTML5-Formulare.
`value`	Ein Inhaltselement, das eine Dateninhaltseinheit umfasst.	Ohne
`rawValue`	Gibt den nicht formatierten Wert für dieses Feld an.	Ohne
`formattedValue`	Gibt den formatierten Wert für dieses Feld an.	Das Festlegen des Werts `formattedValue` mithilfe eines Skripts wird nicht unterstützt.
`editValue`	Gibt den bearbeiteten Wert für dieses Feld an.	Das Festlegen des Werts `editValue` mithilfe eines Skripts wird nicht unterstützt.
`formatMessage`	Gibt die Zeichenfolge der Meldung zur Formatprüfung für dieses Feld an.	Das Festlegen des Werts `formatMessage` mithilfe eines Skripts wird nicht unterstützt.
`fillcolor`	Gibt den Wert der Hintergrundfarbe für dieses Feld an. Sie müssen die Eigenschaft border.fill.presence separat als sichtbar einstellen.	Sie gibt die Standardfarbe des Feldes nicht richtig zurück.
`border`	Das border-Objekt beschreibt den Rahmen, der ein Objekt umgibt.
`ui`	Das ui-Objekt umfasst die Beschreibung der Benutzeroberfläche eines Formularobjekts.
`mandatory`	Gibt den nullTest-Wert für das Feld an.
`borderColor`	Gibt den Rahmenfarbwert für dieses Feld an. Sie müssen die Eigenschaft border.edge.presence separat als sichtbar einstellen.	Sie gibt die Standardfarbe des Feldes nicht richtig zurück.
`length`	Die Anzahl der Elemente in der Liste.	Ohne
`addItem`	Fügt dem aktuellen Feld neue Elemente hinzu.	Ohne
`clearItem`	Entfernt alle Elemente aus dem Feld.	Ohne
`boundItem`	Ruft den Bindewert eines bestimmten Anzeigeelements aus einer Dropdown-Liste oder aus einem Listenfeld ab.	Ohne
`execCalculate`	Führt das Berechnungsskript des Feldes aus.	Ohne
`execValidate`	Führt das Überprüfungsskript des Feldes aus.	Ohne
`execEvent`	Führt das Ereignisskript des Objekts aus.	Ohne
`getItemState`	Gibt den Auswahlstatus des angegebenen Elements zurück.	Ohne
`setItemState`	Legt den Auswahlstatus des angegebenen Elements fest.	Ohne
`getDisplayItem`	Ruft den Elementanzeigetext für den angegebenen Elementindex ab.	Ohne
`getSaveItem`	Ruft den Datenwert für den angegebenen Elementindex ab.	Ohne
`deleteItem`	Entfernt das Element an der angegebenen Indexposition.	Ohne
`setItems`	Legt die angegebenen Elemente im aktuellen Feld fest. Ersetzt die bereits vorhandenen Elemente.	Ohne
h	Eine Maßeinheit für die Höhe des Layouts.	Ohne
w	Eine Maßeinheit für die Breite des Layouts.	Ohne
x	Gibt die X-Koordinate für den Ankerpunkt des Containers in Bezug auf die linke obere Ecke des übergeordneten Containers bei Platzierung anhand eines positionierten Layouts an.	Ohne
y	Gibt die Y-Koordinate für den Ankerpunkt eines Containers in Bezug auf die linke obere Ecke des übergeordneten Containers bei Platzierung anhand eines positionierten Layouts an.	Ohne
caption	Das caption-Objekt stellt eine beschreibende Beschriftung dar, die mit einem Formularentwurfsobjekt verknüpft ist.	Ohne
validate	Das validate-Objekt steuert die Überprüfung von Daten, die benutzerseitig in einem Formular eingegeben werden. Das validate-Objekt kann während der Lebensdauer eines Formulars mehrmals aktiviert werden.	Ohne
parentSubform	Gibt das übergeordnete Teilformular (Seite) dieses Felds an.	Gibt immer übergeordnete Teilformulare zurück statt zuerst übergeordnete Teilformulare ohne Scoping.
selectedIndex	Der Index des ersten ausgewählten Elements.	Ohne

Formular

Eigenschaft	Beschreibung	Ausnahme
formNodes	Gibt eine Liste mit allen Formularmodellobjekten zurück, die an ein bestimmtes Datenobjekt gebunden sind.

InstanceManager

Eigenschaft

Beschreibung

name

Ein Bezeichner, der verwendet wird, um dieses Element in Skriptausdrücken eindeutig zu kennzeichnen.

occur

Beschreibt die Einschränkungen in Bezug auf die Anzahl der zulässigen Instanzen für den zugehörigen einschließenden Container.

min

Gibt die Mindestanzahl der Instanzen an, die instanziiert werden können.

max

Gibt die Höchstanzahl der Instanzen an, die instanziiert werden können.

count

Gibt die aktuelle Anzahl der instanziierten Instanzen an.

setInstances

Fügt die angegebenen Teilformulare oder Teilformularsätze von diesem Knoten zurück oder entfernt diese.

addInstance

Fügt diese Knoten eine neue Instanz eines Teilformulars oder Teilformularsatzes hinzu.

removeInstance

Entfernt ein Teilformular oder einen Teilformularsatz von diesem Knoten.

moveInstance

Verschiebt ein untergeordnetes Objekt eines Formularmodellobjekts an einen anderen angegebenen Speicherort innerhalb des Formularmodells. Die entsprechenden Datenmodellinformationen für das Objekt ziehen innerhalb des Datenmodells ebenfalls um.

insertInstance

Fügt diesem Knoten eine neue Instanz eines Teilformulars oder Teilformularsatzes hinzu.

list

Eigenschaft

Beschreibung

length

Die Anzahl der Elemente in der Liste.

item

Index auf der Basis Null zur Sammlung.

append

Fügt am Ende der Liste der Nodes eine Node an.

remove

Entfernt einen Knoten aus der Knotenliste.

insert

Fügt einen Knoten vor einem bestimmten Knoten in die Knotenliste ein.

node

Eigenschaft

Beschreibung

Ausnahme

createNode

Erstellt einen neuen Knoten basierend auf einem gültigen Klassennamen.

Ohne

isContainer

Gibt an, ob dieses Objekt ein Container-Objekt ist.

Ohne

isNull

Gibt an, ob der aktuelle Datenwert ein Nullwert ist.

Ohne

resolveNode

Wertet den angegebenen SOM-Ausdruck aus, angefangen mit dem aktuellen Objekt des XML-Formularobjektmodells, und gibt den Wert des im SOM-Ausdruck angegebenen Objekts zurück.

Ohne

resolveNodes

Wertet den angegebenen SOM-Ausdruck aus, angefangen mit dem aktuellen Objekt des XML-Formularobjektmodells, und gibt den Wert des im SOM-Ausdruck angegebenen Objekts zurück.

Ohne

oneOfChild

Erstellt einen neuen Knoten basierend auf einem gültigen Klassennamen.

Ohne

getElement

Gibt ein bestimmtes untergeordnetes Objekt zurück.

Ohne

getAttribute

Ruft den Wert einer angegebenen Eigenschaft ab.

Ohne

setAttribute

Legt den Wert einer angegebenen Eigenschaft fest.

Ohne

model

Eigenschaft

Beschreibung

Ausnahme

nicht vorhanden

Teilformular

Eigenschaft

Beschreibung

Ausnahme

instanceIndex

Gibt den Index des Objekts relativ zu den anderen instanziierten Instanzen an.

Ohne

execEvent

Führt das Ereignisskript des Objekts aus.

Ohne

getInvalidObjects

Gibt eine Liste von Knoten in dem Teilformular (einschließlich) zurück, bei denen der Test zur Überprüfung fehlgeschlagen ist.

Ohne

border

Das border-Objekt beschreibt den Rahmen, der ein Objekt umgibt.

Ohne

borderColor

Gibt den Rahmenfarbwert für dieses Feld an. Sie müssen die Eigenschaft border.edge.presence separat als sichtbar einstellen.

Ohne

h

Eine Maßeinheit für die Höhe des Layouts.

Ohne

w

Eine Maßeinheit für die Breite des Layouts.

Ohne

x

Gibt die X-Koordinate für den Ankerpunkt des Containers in Bezug auf die linke obere Ecke des übergeordneten Containers bei Platzierung anhand eines positionierten Layouts an.

Ohne

y

Gibt die Y-Koordinate für den Ankerpunkt eines Containers in Bezug auf die linke obere Ecke des übergeordneten Containers bei Platzierung anhand eines positionierten Layouts an.

Ohne

validate

Das validate-Objekt steuert die Überprüfung von Daten, die benutzerseitig in einem Formular eingegeben werden. Das validate-Objekt kann während der Lebensdauer eines Formulars mehrmals aktiviert werden.

Ohne

name

Eine Kennung, die verwendet wird, um dieses Element in Skriptausdrücken eindeutig zu kennzeichnen.

Ohne

presence

Gibt die Sichtbarkeit eines Objekts an.

Ohne

access

Steuert den Benutzerzugriff auf den Inhalt eines Container-Objekts, beispielsweise ein Teilformular.

Ohne

execValidate

Berechnet den Index eines Teilformulars oder Teilformularsatzes anhand dessen Position im Verhältnis zu anderen Instanzen des gleichen Formularobjekts.

Ohne

InstanceManager

Das instanceManager-Objekt verwaltet das Erstellen, Entfernen und Verschieben einer Instanz von Formularmodellobjekten.

Ohne

submit

Eigenschaft

Beschreibung

target

Die URL, an die die Daten gesendet werden. Bei Auslassung dieses Attributs ruft die XFA-Verarbeitungsanwendung den URI mithilfe eines produktspezifischen Verfahrens ab, z. B. durch Zugreifen auf produktspezifische Informationen im config-Objekt.

tree

Eigenschaft

Beschreibung

Ausnahme

Knoten

Gibt eine Liste aller untergeordneten Objekte des aktuellen Objekts zurück.

Nicht unterstützt für xfa.nodes, desc
Unterschiedliche Anzahl der für PDF und HTML übermittelten Knoten.

name

Gibt den Namen dieses Knotens an.

In HTML kann der Name mithilfe von Skripten nicht festgelegt werden.

parent

Ruft den übergeordneten Knoten dieses Knotens ab.

Ohne

index

Gibt die Position dieses Knotens in der zugehörigen Sammlung von untergeordneten Knoten mit gleichen Namen im Bereich zurück.

Ohne

somExpression

Ruft den SOM-Ausdruck für diesen Knoten ab.

Ohne

resolveNode

Wertet den angegebenen SOM-Ausdruck aus, angefangen mit dem aktuellen Objekt des XML-Formularobjektmodells, und gibt den Wert des im SOM-Ausdruck angegebenen Objekts zurück.

Ohne

resolveNodes

Wertet den angegebenen SOM-Ausdruck aus, angefangen mit dem aktuellen Objekt des XML-Formularobjektmodells, und gibt den Wert des im SOM-Ausdruck angegebenen Objekts zurück.

Ohne

subformset

Eigenschaft

Beschreibung

Ausnahme

InstanceManager

Das instanceManager-Objekt verwaltet das Erstellen, Entfernen und Verschieben einer Instanz von Formularmodellobjekten.

Ohne

content

Eigenschaft

Beschreibung

Ausnahme

isNull

Gibt an, ob der aktuelle Datenwert der Nullwert ist.

dataValue

Eigenschaft

Beschreibung

Ausnahme

isNull

Gibt an, ob der aktuelle Datenwert der Nullwert ist.

edge

Eigenschaft

Beschreibung

Ausnahme

Farbe

Die Eigenschaft „color“ beschreibt eine eindeutige Farbe für das Musterobjekt.

Der Standardwert kann nicht abgerufen werden.
Die Änderungen werden im Modell angezeigt und sind zur Skripterstellung verfügbar, werden aber nicht mit HTML-Elementen synchronisiert. Daher werden die Änderungen nicht auf der Benutzeroberfläche angezeigt.

fill

Eigenschaft

Beschreibung

Ausnahme

Farbe

Die color-Eigenschaften legen eine eindeutige Füllfarbe fest.

Der Standardwert kann nicht abgerufen werden.
Die Änderungen werden im Modell angezeigt und sind zur Skripterstellung verfügbar, werden aber nicht mit HTML-Elementen synchronisiert. Daher werden die Änderungen nicht auf der Benutzeroberfläche angezeigt.

linear

Eigenschaft

Beschreibung

Ausnahme

Farbe

Die color-Eigenschaft beschreibt eine eindeutige Farbe für einen linearen Farbverlauf in einem Formular.

Der Standardwert kann nicht abgerufen werden.
Die Änderungen werden im Modell angezeigt und sind zur Skripterstellung verfügbar, werden aber nicht mit HTML-Elementen synchronisiert. Daher werden die Änderungen nicht auf der Benutzeroberfläche angezeigt.

Zeile

Eigenschaft

Beschreibung

Ausnahme

edge

Das edge-Objekt beschreibt einen Bogen, eine Linie oder eine Seite eines Rahmens oder Rechtecks.

Attribute wie „color“, „cap“ usw. werden nicht unterstützt.

pattern

Eigenschaft

Beschreibung

Ausnahme

Farbe

Die Eigenschaft „color“ beschreibt eine eindeutige Farbe für das Musterobjekt.

Der Standardwert kann nicht abgerufen werden.
Die Änderungen werden im Modell angezeigt und sind zur Skripterstellung verfügbar, werden aber nicht mit HTML-Elementen synchronisiert. Daher werden die Änderungen nicht auf der Benutzeroberfläche angezeigt.

radial

Eigenschaft

Beschreibung

Ausnahme

Farbe

Die color-Eigenschaft beschreibt eine eindeutige Farbe für das radial-Objekt.

Der Standardwert kann nicht abgerufen werden.
Die Änderungen werden im Modell angezeigt und sind zur Skripterstellung verfügbar, werden aber nicht mit HTML-Elementen synchronisiert. Daher werden die Änderungen nicht auf der Benutzeroberfläche angezeigt.

stipple

Eigenschaft

Beschreibung

Ausnahme

Farbe

Die color-Eigenschaft beschreibt eine eindeutige Farbe für das stipple-Objekt.

Der Standardwert kann nicht abgerufen werden.
Die Änderungen werden im Modell angezeigt und sind zur Skripterstellung verfügbar, werden aber nicht mit HTML-Elementen synchronisiert. Daher werden die Änderungen nicht auf der Benutzeroberfläche angezeigt.

draw

Eigenschaft

Beschreibung

Ausnahme

ui

Das ui-Objekt umfasst die Beschreibung der Benutzeroberfläche eines Formularobjekts.

caption

Das caption-Objekt beschreibt eine beschreibende Bezeichnung, die mit einem Formularentwurfsobjekt verknüpft ist.

presence

Gibt die Sichtbarkeit eines Objekts an.

name

Gibt eine Kennung an, mit der dieses Objekt oder Ereignis in Skriptausdrücken angegeben werden kann.

Die Festlegung des Werts zur Laufzeit wird nicht unterstützt

value

Das value-Objekt umfasst eine einzige Dateninhaltseinheit.

corner

Eigenschaft

Beschreibung

Ausnahme

Farbe

Die color-Eigenschaft beschreibt eine eindeutige Farbe für das corner-Objekt.

Der Standardwert kann nicht abgerufen werden.
Die Änderungen werden im Modell angezeigt und sind zur Skripterstellung verfügbar, werden aber nicht mit HTML-Elementen synchronisiert. Daher werden die Änderungen nicht auf der Benutzeroberfläche angezeigt.

checkButton

Eigenschaft

Beschreibung

Ausnahme

border

Das border-Objekt beschreibt den Rahmen, der das checkButton-Objekt umgibt.

Die Änderungen werden im Modell angezeigt und sind zur Skripterstellung verfügbar, werden aber nicht mit HTML-Elementen synchronisiert. Daher werden die Änderungen nicht auf der Benutzeroberfläche angezeigt.

choiceList

Eigenschaft

Beschreibung

Ausnahme

border

Das border-Objekt beschreibt den Rahmen, der das choiceList-Objekt umgibt.

dateTimeEdit

Eigenschaft

Beschreibung

Ausnahme

border

Das border-Objekt beschreibt den Rahmen, der das dateTimeEdit-Objekt umgibt.

Bild

Eigenschaft

Beschreibung

Ausnahme

contentType

Gibt den Inhaltstyp im referenzierten Dokument an, ausgedrückt als MIME-Typ.

Ohne

name

Eine Kennung, die verwendet wird, um dieses Element in Skriptausdrücken eindeutig zu kennzeichnen.

Ohne

Eigenschaft

Beschreibung

Ausnahme

layout

Gibt die von diesem Objekt zu verwendende Layout-Strategie an.

Ohne

border

Gibt den Rahmen an, der dieses Feld umgibt.

Ohne

mandatory

Gibt den nullTest-Wert für das Feld an.

Ohne

borderColor

Gibt den Rahmenfarbwert für dieses Feld an. Bevor die Farbe mithilfe der Skripterstellung geändert werden kann, muss ein Rahmen definiert werden.

Ohne

borderWidth

Gibt die Rahmenbreite für dieses Feld an.

Ohne

h

Eine Maßeinheit für die Höhe des Layouts.

Ohne

transient

Gibt an, ob die verarbeitende Anwendung den Wert der Ausschlussgruppe im Rahmen eines Formularsende- oder -speichervorgangs speichern muss.

Ohne

w

Eine Maßeinheit für die Breite des Layouts.

Ohne

x

Gibt die X-Koordinate für den Ankerpunkt des Containers in Bezug auf die linke obere Ecke des übergeordneten Containers bei Platzierung anhand eines positionierten Layouts an.

Ohne

y

Gibt die Y-Koordinate für den Ankerpunkt eines Containers in Bezug auf die linke obere Ecke des übergeordneten Containers bei Platzierung anhand eines positionierten Layouts an.

Ohne

caption

Das caption-Objekt stellt eine beschreibende Beschriftung dar, die mit einem Formularentwurfsobjekt verknüpft ist.

Ohne

validate

Das validate-Objekt steuert die Überprüfung von Daten, die benutzerseitig in einem Formular eingegeben werden. Das validate-Objekt kann während der Lebensdauer eines Formulars mehrmals aktiviert werden.

Ohne

dataNode

Ruft den Datenknoten ab, an den ein Formularknoten nach dem Zusammenführen gebunden ist.

Ohne

presence

Gibt die Sichtbarkeit eines Objekts an.

access

Steuert den Benutzerzugriff auf den Inhalt eines Container-Objekts, beispielsweise ein Teilformular.

Wird für einzelne Elemente der exclgrp immer offen zurückgegeben.

name

Gibt eine Kennung an, mit der dieses Objekt oder Ereignis in Skriptausdrücken angegeben werden kann.

Ohne

members

Gibt die Elemente einer Ausschlussgruppe an.

Ohne

selectedMember

Gibt das ausgewählte Element einer Ausschlussgruppe zurück.

Ohne

execCalculate

Führt Skripte für das calculate-Ereignis des angegebenen Objekts und etwaiger untergeordneter Objekte aus.

Ohne

calculate

Das calculate-Objekt steuert die Berechnung des Werts eines Felds.

Ohne

arc

Eigenschaft

Beschreibung

Ausnahme

edge

Das edge-Objekt beschreibt einen Bogen, eine Linie oder eine Seite eines Rahmens oder Rechtecks.

Attribute wie „color“, „cap“ usw. werden nicht unterstützt.

border

Eigenschaft

Beschreibung

Ausnahme

edge

Das edge-Objekt beschreibt einen Bogen, eine Linie oder eine Seite eines Rahmens oder Rechtecks.

Attribute wie „color“, „cap“ usw. werden nicht unterstützt.

$layout

Eigenschaft

Beschreibung

Ausnahme

h

Bestimmt die Höhe eines angegebenen Formularentwurfsobjekts.

Die Eigenschaft „Höhe“ (h) wird für Seiten- und Inhaltsbereiche nicht unterstützt.
Parameter „Offset vom ersten Inhaltsbereich, in dem das XFA-Formularobjekt auftritt“ wird nicht unterstützt.

w

Bestimmt die Breite eines angegebenen Formularentwurfsobjekts.

Die Eigenschaft „Breite“ (w) wird für Seiten- und Inhaltsbereiche nicht unterstützt.
Parameter „Offset vom ersten Inhaltsbereich, in dem das XFA-Formularobjekt auftritt“ wird nicht unterstützt.

x

Bestimmt die X-Koordinate eines angegebenen Formularentwurfsobjekts relativ zum übergeordneten Objekt.

Die Eigenschaft „X-Koordinate“ (x) wird für Seiten- und Inhaltsbereiche nicht unterstützt.
Parameter „Offset vom ersten Inhaltsbereich, in dem das XFA-Formularobjekt auftritt“ wird nicht unterstützt.

y

Bestimmt die Y-Koordinate eines angegebenen Formularentwurfsobjekts relativ zum übergeordneten Objekt.

Die Eigenschaft „Y-Koordinate“ (y) wird für Seiten- und Inhaltsbereiche nicht unterstützt.
Parameter „Offset vom ersten Inhaltsbereich, in dem das XFA-Formularobjekt auftritt“ wird nicht unterstützt.

pagecount

Bestimmt die Anzahl der Seiten des aktuellen Formulars.

Die Methode „layout.pageCount()“ gibt unterschiedliche Werte für PDF- und HTML-Formulare zurück.
Die Methode „absPageCount“ gibt bei geringerer Seitenzahl durch ausgeblendete Objekte einen falschen Wert zurück.

pagecontent

Ruft Formularentwurfsobjekttypen von einer angegebenen Seite eines Formulars ab.

Ohne

absPageCount

Bestimmt die Seitenzahl des aktuellen Formulars.

Die Methode „layout.pageCount()“ gibt unterschiedliche Werte für PDF- und HTML-Formulare zurück.
Die Methode „absPageCount“ gibt bei geringerer Seitenzahl durch ausgeblendete Objekte einen falschen Wert wieder.

items

Eigenschaft

Beschreibung

Ausnahme

presence

Gibt die Sichtbarkeit eines Objekts an.

Ohne

FormCalc

„FormCalc“ ist eine XFA-spezifische Sprache zum Erstellen von E-Formular-orientierter Logik und Berechnungsstämmen. „FormCalculation“ stellt einen umfangreichen Satz an Erstellungsfunktionen bereit.

Von FormCalc unterstützte Funktionen

Von FormCalc unterstützte Ausdrücke

Kategorie

Beschreibung

Beispiel

Einfacher Ausdruck

Addieren, subtrahieren, multiplizieren, dividieren und Klammern

(a+b)*3

Variablendeklaration

Definieren einer Variablen

var a
var a=3
a=3

Logischer Ausdruck

Logik (und/oder)
Vergleich (größer/kleiner/gleich)

A oder 1
1 <> 2
A NE B
A oder 1
1 <> 2
A NE B

If-Ausdruck

if (a>b) then 2 endif

Zeit

while (i lt 5) do i = i + 1 endwhile

für

for i = 100 downto 1
do s = s + i endfor

for each

for each i in (1, 2, 3)
do s = s + i endfor

Funktionsdeklaration

Definieren einer benutzerdefinierten Funktion in FormCalc

func foo(n) do var f = n endfunc

Acrobat-API-Unterstützung

Arithmetik-Funktionen
1. Abs()
2. Avg()
3. Ceil()
4. Anzahl()
5. Floor()
6. Maximal()
7. Min()
8. Mod()
9. Round()
10. Sum()
Wissenschaftliche Funktionen
1. Acos()
2. Asin()
3. Atan()
4. Atan2()
5. Cos()
6. Sin()
7. Tan()
8. Exp()
9. Log()
10. Pow()
11. Sqrt()
12. Deg2Rad()
13. Rad2Deg()
14. Pi()
Finanzfunktionen
1. Apr()
2. Cterm()
3. Fv()
4. Ipmt()
5. Npv()
6. Pmt()
7. Ppmt()
8. Pv()
9. Rate()
10. Begriff()
Logikfunktionen
1. Choose()
2. If()
3. Oneof()
4. Within()
Zeichenfolgen-Funktionen
1. At()
2. Concat()
3. Left()
4. Len()
5. Lower()
6. Ltrim()
7. Ersetzen()
8. Right()
9. Rtrim()
10. Space()
11. Stuff()
12. Substr()
13. Upper()
14. WordNum()
Datum und Uhrzeit
1. Datum()
2. num2date()
3. DateFmt()

API

Beschreibung

Abweichung

console.println()

Diese Acrobat-API gibt die Ausgabe an die JavaScript-Konsole aus.

app.alert()

Diese Acrobat-API sendet eine Warnmeldung als JavaScript-Popup.

app.beep()

Lässt das System einen Ton abspielen.

Es wird keine Aktion ausgeführt.

app.execDialog()

Zeigt Benutzenden ein modales Dialogfeld an. Modale Dialogfelder müssen zuerst geschlossen werden, um die Host-Anwendung direkt wieder verwenden zu können.

Es wird keine Aktion ausgeführt.

app.launchURL()

Startet eine URL in einem Browser-Fenster.

app.setInterval()

Gibt ein JavaScript-Skript und einen Zeitraum an. Das Skript wird jedes Mal ausgeführt, wenn dieser Zeitraum abgelaufen ist. Der Rückgabewert dieser Methode muss in einer JavaScript-Variable erfasst werden. Andernfalls unterliegt das Intervallobjekt der Garbage Collection und die Uhr würde angehalten werden. Um die regelmäßige Ausführung zu beenden, übergeben Sie das zurückgegebene Intervallobjekt an clearInterval.

app.setTimeOut()

Gibt ein JavaScript-Skript und einen Zeitraum an. Das Skript wird nur einmal nach dem Ablauf des Zeitraums ausgeführt. Der Rückgabewert dieser Methode muss in einer JavaScript-Variable erfasst werden. Andernfalls unterliegt das Zeitüberschreitungsobjekt der Garbage Collection und die Uhr würde angehalten werden. Um das Zeitüberschreitungsereignis zu beenden, übergeben Sie das zurückgegebene Zeitüberschreitungsobjekt an clearTimeOut.

app.clearInterval()

Bricht ein zuvor registriertes Intervall ab, das anfangs mit der Methode setInterval festgelegt wurde.

Die API wird in HTML5-Formularen nicht ordnungsgemäß ausgeführt.

app.clearTimeOut()

Bricht ein zuvor registriertes Zeitüberschreitungsintervall ab. Ein solches Intervall wird anfangs mit setTimeOut festgelegt.

Die API wird in HTML5-Formularen nicht ordnungsgemäß ausgeführt.

app.eval()

Führt ein bestimmtes Skript aus.

app.activeDocs

Ein Array, das das doc-Objekt für jedes aktive Dokument enthält. Wenn keine Dokumente aktiv sind, gibt activeDocs keinen Wert zurück. Das heißt, es weist das gleiche Verhalten auf wie d = new Array(0) im Core-JavaScript.

Gibt ein leeres Array für HTML5-Formulare zurück.

app.calculate

Wenn „true“ (Standardwert), können Berechnungen ausgeführt werden. Wenn „false“, werden keine Berechnungen zugelassen.

Bei HTML5-Formularen ist der Wert immer „true“.

app.constants

Ein Wrapper-Objekt zum Erfassen von verschiedenen konstanten Werten. Derzeit gibt diese Eigenschaft ein Objekt mit einer Eigenschaft zurück, nämlich „align“.

HTML5-Formulare geben ein leeres align-Objekt zurück.

app.focusRect

Aktiviert und deaktiviert das Fokusrechteck. Das Fokusrechteck ist die schwach gepunktete Linie um die Schaltflächen, Kontrollkästchen, Optionsfelder und Signaturen und zeigt an, dass das Formularfeld den Tastaturfokus hat. Mit dem Wert „true“ wird das Fokusrechteck aktiviert.

Bei HTML5-Formularen ist der Wert immer „true“.

app.formsVersion

Die Versionsnummer der Viewer-Formular-Software. Aktivieren Sie diese Eigenschaft, um festzulegen, ob Objekte, Eigenschaften oder Methoden in den neueren Versionen der Software verfügbar sind, wenn Sie die Abwärtskompatibilität in den Skripten beibehalten möchten.

Immer 11.001.

app.language

Die Sprache des aktuellen Acrobat Viewer.

In HTML5-Formularen immer „ENU“.

Unterstützte XFA-Ereignisse

Folgende Client-seitige XFA-Ereignisse werden unterstützt:

Initialisieren
Validieren
Berechnen
Klicken Sie auf
Geben Sie ein
Beenden
Änderung
ValidationState

NOTE

HTML5-Formulare werden clientseitig (im Browser) wiedergegeben. Verwenden Sie Client-seitige Validierungs- und Berechnungsskripte anstelle Server-seitiger Skripte.

recommendation-more-help