Skriptunterstützung für HTML5-Formulare
15. Juli 2024
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.
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
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äß:
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
presenceSteuert 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
accessSteuert 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.
nameEine 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.
valueEin Inhaltselement, das eine Dateninhaltseinheit umfasst.
Ohne
rawValueGibt den nicht formatierten Wert für dieses Feld an.
Ohne
formattedValueGibt den formatierten Wert für dieses Feld an.
Das Festlegen des Werts
formattedValue mithilfe eines Skripts wird nicht unterstützt.editValueGibt den bearbeiteten Wert für dieses Feld an.
Das Festlegen des Werts
editValue mithilfe eines Skripts wird nicht unterstützt.formatMessageGibt die Zeichenfolge der Meldung zur Formatprüfung für dieses Feld an.
Das Festlegen des Werts
formatMessage mithilfe eines Skripts wird nicht unterstützt.fillcolorGibt 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.
borderDas border-Objekt beschreibt den Rahmen, der ein Objekt umgibt.
uiDas ui-Objekt umfasst die Beschreibung der Benutzeroberfläche eines Formularobjekts.
mandatoryGibt den nullTest-Wert für das Feld an.
borderColorGibt 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.
lengthDie Anzahl der Elemente in der Liste.
Ohne
addItemFügt dem aktuellen Feld neue Elemente hinzu.
Ohne
clearItemEntfernt alle Elemente aus dem Feld.
Ohne
boundItemRuft den Bindewert eines bestimmten Anzeigeelements aus einer Dropdown-Liste oder aus einem Listenfeld ab.
Ohne
execCalculateFührt das Berechnungsskript des Feldes aus.
Ohne
execValidateFührt das Überprüfungsskript des Feldes aus.
Ohne
execEventFührt das Ereignisskript des Objekts aus.
Ohne
getItemStateGibt den Auswahlstatus des angegebenen Elements zurück.
Ohne
setItemStateLegt den Auswahlstatus des angegebenen Elements fest.
Ohne
getDisplayItemRuft den Elementanzeigetext für den angegebenen Elementindex ab.
Ohne
getSaveItemRuft den Datenwert für den angegebenen Elementindex ab.
Ohne
deleteItemEntfernt das Element an der angegebenen Indexposition.
Ohne
setItemsLegt 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
nameEin Bezeichner, der verwendet wird, um dieses Element in Skriptausdrücken eindeutig zu kennzeichnen.
occurBeschreibt die Einschränkungen in Bezug auf die Anzahl der zulässigen Instanzen für den zugehörigen einschließenden Container.
minGibt die Mindestanzahl der Instanzen an, die instanziiert werden können.
maxGibt die Höchstanzahl der Instanzen an, die instanziiert werden können.
countGibt die aktuelle Anzahl der instanziierten Instanzen an.
setInstancesFügt die angegebenen Teilformulare oder Teilformularsätze von diesem Knoten zurück oder entfernt diese.
addInstanceFügt diese Knoten eine neue Instanz eines Teilformulars oder Teilformularsatzes hinzu.
removeInstanceEntfernt ein Teilformular oder einen Teilformularsatz von diesem Knoten.
moveInstanceVerschiebt 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.
insertInstanceFügt diesem Knoten eine neue Instanz eines Teilformulars oder Teilformularsatzes hinzu.
list
Eigenschaft
Beschreibung
lengthDie Anzahl der Elemente in der Liste.
itemIndex auf der Basis Null zur Sammlung.
appendFügt am Ende der Liste der Nodes eine Node an.
removeEntfernt einen Knoten aus der Knotenliste.
insertFü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
isContainerGibt an, ob dieses Objekt ein Container-Objekt ist.
Ohne
isNullGibt an, ob der aktuelle Datenwert ein Nullwert ist.
Ohne
resolveNodeWertet 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
resolveNodesWertet 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
nicht vorhanden
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
imageEdit
Eigenschaft
Beschreibung
Ausnahme
border
Das border-Objekt beschreibt den Rahmen, der das imageEdit-Objekt umgibt.
numericEdit
Eigenschaft
Beschreibung
Ausnahme
border
Das border-Objekt beschreibt den Rahmen, der ein Objekt umgibt.
keine
object
Eigenschaft
Beschreibung
Ausnahme
className
Legt den Namen der Klasse dieses Objekts fest.
keine
rectangle
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.
textEdit
Eigenschaft
Beschreibung
Ausnahme
border
Das border-Objekt beschreibt den Rahmen, der ein Objekt umgibt.
Ohne
exclGroup
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
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
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
do s = s + i endfor
for each
for each i in (1, 2, 3)
do s = s + i endfor
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
- Abs()
- Avg()
- Ceil()
- Anzahl()
- Floor()
- Maximal()
- Min()
- Mod()
- Round()
- Sum()
-
Wissenschaftliche Funktionen
- Acos()
- Asin()
- Atan()
- Atan2()
- Cos()
- Sin()
- Tan()
- Exp()
- Log()
- Pow()
- Sqrt()
- Deg2Rad()
- Rad2Deg()
- Pi()
-
Finanzfunktionen
- Apr()
- Cterm()
- Fv()
- Ipmt()
- Npv()
- Pmt()
- Ppmt()
- Pv()
- Rate()
- Begriff()
-
Logikfunktionen
- Choose()
- If()
- Oneof()
- Within()
-
Zeichenfolgen-Funktionen
- At()
- Concat()
- Left()
- Len()
- Lower()
- Ltrim()
- Ersetzen()
- Right()
- Rtrim()
- Space()
- Stuff()
- Substr()
- Upper()
- WordNum()
-
Datum und Uhrzeit
- Datum()
- num2date()
- 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
NOTEHTML5-Formulare werden clientseitig (im Browser) wiedergegeben. Verwenden Sie Client-seitige Validierungs- und Berechnungsskripte anstelle Server-seitiger Skripte.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2