Mit Host-Anwendungen arbeiten

Eigenschaften und Methoden des Host-Skriptmodells
Die Funktionalität des Host-Skriptmodells im Vergleich

Unter einer Host-Anwendung versteht man die Anwendung, in der ein Formular zu einem bestimmten Zeitpunkt vorhanden ist.

Wenn Sie beispielsweise ein Formular mit Forms im HTML-Format wiedergeben, ist Forms in der Phase vor dem Wiedergabeprozess die Host-Anwendung.

Sobald Sie ein Formular wiedergeben und in einer Client-Anwendung wie Acrobat, Adobe Reader oder einem HTML-Browser anzeigen, wird die Client-Anwendung zur Host-Anwendung.

In Designer steht ein Skriptmodell mit Eigenschaften und Methoden zur Herstellung einer direkten Verbindung zur Host-Anwendung zur Verfügung. Beispielsweise können Sie mit den Eigenschaften und Methoden des Host-Skriptmodells in Acrobat oder Adobe Reader Navigationsaktionen für PDF-Seiten bereitstellen sowie mit der Methode importData Daten in ein Formular laden.

Sie können die Host-Skriptmodellsyntax bei jedem gültigen Skriptereignis für Formularentwurfsobjekte mit der folgenden Syntax in FormCalc und JavaScript referenzieren:

xfa.host.property_or_method

Eigenschaften und Methoden des Host-Skriptmodells

Mit Hilfe der Eigenschaften und Methoden des Host-Skriptmodells können Sie Informationen abrufen und Aktionen ausführen, die normalerweise über Berechnungen und Skripten nicht zugänglich sind. Sie können etwa den Namen der Host-Anwendung abrufen (z. B. Acrobat) oder bei einem interaktiven Formular von der aktuellen Seite aus weiterblättern. In der folgenden Tabelle werden die für das Host-Skriptmodell verfügbaren Eigenschaften und Methoden aufgeführt.

Eigenschaften	Methoden
`appType`	`beep`
`calculationsEnabled`	`exportData`
`currentPage`	`gotoURL`
`language`	`importData`
`name`	`messageBox`
`numPages`	`pageDown`
`Plattform`	`pageUp`
`title`	`print`
`validationsEnabled`	`resetData`
`variation`	`response`
`version`	`setFocus`

Weitere Informationen zu den Eigenschaften und Methoden des Host-Skriptmodells finden Sie im LiveCycle Developer Center.

Die Funktionalität des Host-Skriptmodells im Vergleich

In der folgenden Tabelle werden die Eigenschaften und Methoden des Host-Skriptmodells von Designer aufgeführt und den entsprechenden Ausdrücken im JavaScript-Objektmodell von Acrobat gegenübergestellt.

Weitere Informationen zu den Eigenschaften und Methoden des Host-Skriptmodells finden Sie in der Designer-Hilfe oder in der Skriptreferenz.

Eigenschaften und Methoden des Host-Skriptmodells	Acrobat-Entsprechungen im JavaScript-Objektmodell
`xfa.host.appType`	`app.viewerType`
`xfa.host.beep( [ INTEGER param ] )`	`app.beep([ nType ])`
`xfa.host.currentPage`	`doc.pageNum`
`xfa.host.exportData([ STRING param1 [, BOOLEAN param2 ] ])`	`doc.exportXFAData(cPath [, bXDP ])`
`xfa.host.gotoURL( STRING param1 )`	`doc.getURL(cURL, [ bAppend ])` oder `app.launchURL(URL);`
`xfa.host.importData( [ STRING param ] )`	`doc.importXFAData(cPath)`
`xfa.host.language`	`app.language`
`xfa.host.messageBox(STRING param1 [, STRING param2 [, INTEGER param3 [, INTEGER param4 ] ] ])`	`app.alert(cMsg [, nIcon [, nType [, cTitle ] ] ])`
`xfa.host.name`	Keine
`xfa.host.numPages`	`doc.numPages`
`xfa.host.pageDown()`	`doc.pageNum++`
`xfa.host.pageUp()`	`doc.pageNum--`
`xfa.host.platform`	`app.platform`
`xfa.host.print(BOOLEAN param1, INTEGER param2, INTEGER param3, BOOLEAN param4, BOOLEAN param5, BOOLEAN param6, BOOLEAN param7, BOOLEAN param8)`	`doc.print([ bUI [, nStart [, nEnd [, bSilent [, bShrinkToFit [, bPrintAsImage [, bReverse [, bAnnotations ] ] ] ] ] ] ] ])`
`xfa.host.resetData( [ STRING param ] )`	`doc.resetForm([ aFields ])`
`xfa.host.response( STRING param1 [, STRING param2 [, STRING param3 [, BOOLEAN param4] ] ])`	`app.response(cQuestion [, cTitle [, cDefault [, bPassword ] ] ])`
`xfa.host.setFocus( STRING param )`	`field.setFocus()` (Nicht weiter unterstützt)
`xfa.host.title`	`doc.title`
`xfa.host.variation`	`app.viewerVariation`
`xfa.host.version`	`app.viewerVersion`