ホストアプリケーションの使用

ホストアプリケーションとは、所定の時期にフォームが存在するアプリケーションです。

例えば、Forms を使用し、HTML 形式でフォームをレンダリングする場合、レンダリング前の処理時のホストアプリケーションは Forms になります。

レンダリングの後、Acrobat、Adobe Reader、HTML ブラウザーなどのクライアントアプリケーションでフォームを表示すると、このクライアントアプリケーションがホストアプリケーションになります。

Designer には、ホストアプリケーションに直結するスクリプティングプロパティとスクリプティングメソッドを備えたスクリプトモデルが含まれています。例えば、ホストスクリプトモデルのプロパティとメソッドを使用して Acrobat または Adobe Reader で PDF ページの表示切り替えアクションを実行したり、importData をメソッドを使用してデータをフォームに読み込んだりできます。

FormCalc および JavaScript に次の構文を使用すると、フォームデザインオブジェクトに有効なスクリプティングイベントでホストスクリプトモデル構文を参照できます。

    xfa.host.property_or_method

ホストスクリプトモデルのプロパティおよびメソッド

ホストスクリプトモデルのプロパティおよびメソッドを使用すれば、演算やスクリプトでは通常アクセスできない情報を取得し、アクションを実行できるようになります。例えば、ホストアプリケーションの名前(Acrobat など)を取得したり、インタラクティブフォームの現在のページに進んだりできます。ホストスクリプトモデルに使用できるプロパティとメソッドを以下の表に示します。

ホストスクリプトモデルのプロパティおよびメソッドについて詳しくは、LiveCycle デベロッパーセンターを参照してください。

ホストスクリプトモデル機能の比較

この表は、Designer ホストスクリプトモデルのプロパティとメソッドを示し、Acrobat の JavaScript オブジェクトモデルにある等価な表現と比較しています。

ホストスクリプトモデルのプロパティおよびメソッドについて詳しくは、Designer ヘルプまたは、『スクリプティングリファレンス』を参照してください。

ホストスクリプトモデルのプロパティおよびメソッド

Acrobat における等価な 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 ])

または

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

なし

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()

(非推奨)

xfa.host.title

doc.title

xfa.host.variation

app.viewerVariation

xfa.host.version

app.viewerVersion