Como trabalhar com um aplicativo host

Propriedades e métodos do modelo de scripts host
Comparação da funcionalidade do modelo de scripts host

Um aplicativo host é o aplicativo no qual um formulário existe em um determinado horário.

Por exemplo, se você estiver usando os Forms para renderizar um formulário no formato HTML, então, durante o processo de pré-renderização, o aplicativo host será Forms.

Assim que você renderizar um formulário e exibi-lo em um aplicativo cliente como Acrobat, Adobe Reader ou um navegador HTML, então o aplicativo cliente se tornará o aplicativo host.

O Designer inclui um modelo de scripts que fornece as propriedades e os métodos de scripts para estabelecer uma interface direta com um aplicativo host. Por exemplo, é possível usar as propriedades e os métodos no modelo de scripts host para fornecer as ações de navegação da página em PDF no Acrobat ou no Adobe Reader ou é possível usar o método importData para carregar dados em seu formulário.

É possível fazer referência à sintaxe do modelo de scripts host em qualquer evento de script válido para objetos de design de formulários usando a seguinte sintaxe para FormCalc e JavaScript:

xfa.host.property_or_method

Propriedades e métodos do modelo de scripts host

Usando as propriedades e os métodos do modelo de scripts host, é possível recuperar informações e executar ações que, de outra forma, não estariam acessíveis por meio de cálculos e scripts. Por exemplo, é possível recuperar o nome do aplicativo host (como o Acrobat) ou apresentar a página atual em um formulário interativo. A tabela a seguir lista as propriedades e os métodos que estão disponíveis para o modelo de scripts host.

Propriedades	Métodos
`appType`	`beep`
`calculationsEnabled`	`exportData`
`currentPage`	`gotoURL`
`language`	`importData`
`name`	`messageBox`
`numPages`	`pageDown`
`platform`	`pageUp`
`title`	`print`
`validationsEnabled`	`resetData`
`variation`	`response`
`version`	`setFocus`

Para obter mais informações sobre as propriedades e os métodos de modelo de scripts host, consulte o LiveCycle Developer Center.

Comparação da funcionalidade do modelo de scripts host

Esta tabela lista as propriedades e os métodos do modelo de scripts host do Designer e os compara às expressões equivalentes no Modelo de objeto JavaScript no Acrobat.

Para obter mais informações sobre os métodos e propriedades do modelo de scripts host, consulte Ajuda do Designer ou consulte a Referência de script.

Propriedades e métodos do modelo de scripts host	Equivalentes do Acrobat do Modelo de objeto JavaScript
`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 ])` ou `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`	none
`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()` (Obsoleto)
`xfa.host.title`	`doc.title`
`xfa.host.variation`	`app.viewerVariation`
`xfa.host.version`	`app.viewerVersion`