User Guide    高度な機能    JavaScriptの編集と追加

JavaScriptの編集と追加

(PDFpenProの高度な機能)

JavaScriptは、PDFpenProでPDFフォームでカスタム関数またはアクションを作成するために使用されます。 Javascriptコマンドは、計算、書式設定、検証、およびその他の多くのことのためのフォームフィールドに適用できます。 既存のスクリプトを編集したり、新しいスクリプトを追加したりするには、JavaScriptプログラミングの高度な知識が必要です。 一般的またはAdobe固有のJavaScriptプログラミングを支援するリソースは、w3schools.compdfscripting.com、Adobe、およびその他の多くのソースからオンラインで入手できます。

注意:PDFpenPro はAcroform PDFフォームのJavaScriptのみをサポートしています。 LiveCycle(XFA)ドキュメントのJavaScriptはサポートしていません。

JavaScriptとは?

JavaScriptは、オブジェクト指向のコンピュータープログラミング言語です。 これは通常、Webブラウザー内でインタラクティブな効果を作成するために使用され、PDFもパワフルにカスタマイズできます。

PDFpenPro スクリプトウィンドウを介して既存のJavaScriptを表示、追加、削除、または編集できます。 ドキュメント内のJavaScriptは、ドキュメントスクリプトまたはページスクリプトとして一覧表示されます。 JavaScriptには一般的に4つのタイプがあります。

ドキュメントスクリプト:ドキュメントレベルのスクリプトは、PDFドキュメントのスクリプト階層の最上位にあるスクリプトです。 これらのスクリプトは、PDFpenProでドキュメントが読み込まれたときに最初に実行されるスクリプトです。 。 これは、操作の設定、トップレベルの環境テストの実行、またはドキュメント内の他のスクリプトで使用される特定の関数と変数の定義に使用されます。

ドキュメントアクション:ドキュメントアクションは、ドキュメントを閉じる、保存する、印刷するなどのアクティビティによって実行されるイベントです。 ドキュメントの「アクション」により、フォーム設計者はこれらのアクティビティの前後にドキュメントを変更できます。 通常、5つのドキュメントアクションがあります。

  • Will Close (閉まります):PDFを閉じる前にプロンプトが表示されます。 このアクションは主に、ドキュメントにビデオなどの高度なインタラクティブマルチメディアが含まれている場合に、何かをシャットオフするなどのクリーンアップに使用されます。
  • Will Save (保存します):PDFを保存する前にプロンプトが表示されます。 このアクションは主に、保存されているドキュメントのバージョンを区別するために自動変更を行う場合に使用されます。
  • Did Save (保存しました):PDFを保存した後にプロンプトが表示されます。 このアクションは主に、「保存する」アクションで行われた変更を復元するために使用されます。
  • Will Print (印刷します):PDFを印刷する前にプロンプトが表示されます。 このアクションは主に、PDFのヘッダーやスタンプを表示するなど、ドキュメントに視覚的な変更を加えるために使用されます。
  • Did Print (印刷しました):PDFを印刷キューに追加した後にプロンプトが表示されます。 このアクションは主に、「印刷します」アクションでドキュメントに加えられた変更を復元するために使用されます。

ページアクション:ページレベルのアクションは、開く、閉じるなど、ページレベルでトリガーされるイベントです。 たとえば、ページを「開く」とは、ドキュメントの特定のページが完全に表示され、関連するページ番号がツールバーに反映されている場合を指します。 ページを「閉じる」とは、ドキュメントの特定のページが完全に表示されなくなり、関連するページ番号がツールバーに反映されなくなった場合を指します。 これらのアクションは、タイマー、ビデオ、アニメーションなど、現在PDFpenProがサポートしていない可能性のあるインタラクティブマルチメディアを含むページを管理する場合に一般的に役立ちます。

注釈アクション:注釈アクションは、主にフォームフィールドのフォーム要素に関連付けられたページレベルのイベントです。 これらのアクションにより、特定の注釈のカスタム関数またはフォーマットが有効になります。 ユーザーは、フォームフィールドの特定の書式設定、計算、または検証を編集または追加できます。 フォームフィールドスクリプトには、「ウィジェットスクリプト」と「フォーム値スクリプト」の2つの主要なタイプのスクリプトが含まれます。 ウィジェットスクリプトは、フィールドで実行されるアクションです。 フォーム値スクリプトは、フォームフィールドの値が変更されたときに発生するアクションです。

  • Enter (入る):ウィジェットスクリプトが、カーソルがフォームフィールドに入ると実行されます。
  • Exit (出口):カーソルがフォームフィールドを離れると、ウィジェットスクリプトが実行されます。
  • Focus (フォーカス):ウィジェットスクリプトが、フォームフィールドがキーボードフォーカスに到達したときに実行されます。
  • Blur (ぼかし):ウィジェットスクリプトが、フォームフィールドがキーボードフォーカスを失ったときに実行されます。
  • Mouse up (マウスアップ):ウィジェットスクリプトが、マウス/カーソルをフォームフィールドに合わせ、ユーザーがボタンをクリックすると実行されます。
  • Mouse down (マウスダウン):ウィジェットスクリプトが、マウス/カーソルがフォームフィールドにカーソルを合わせ、マウスボタンが離されたときに実行されます。
  • Page opened (ページを開きました):ページアクションを参照してください。
  • Page closed (ページを閉じました):ページアクションを参照してください。
  • Format (フォーマット):「検証」スクリプトがtrueの場合、「フォーム値」スクリプトが「検証」スクリプトの後に実行されます。
  • Validate (検証):「フォーム値」スクリプトが、ドキュメント内の関連するフィールド値が変更されたときに実行されます。
  • Calculate (計算する):フォーム値スクリプトは、ドキュメントのフィールド値が変更されたときに実行されます。
  • Keystroke (キーストローク):「フォーム値」スクリプトが、キーストロークがテキストフィールドに入力されたときに実行されます。

注意:ユーザーは、ドキュメントレベルとページレベルの両方で利用可能なすべてのスクリプトを表示できます。 ただし、すべてのスクリプトは技術的には編集できる一方で、PDFpenProはすべてのJavaScriptをサポートしているわけではありません。 例として、PDFpenProは現在、インタラクティブビデオなどの特定のマルチメディアをサポートしていません。 ただし、アプリケーションは、アラート、計算、フォーマット、検証などの一般的なJavaScriptをサポートしています

JavaScriptの環境設定

JavaScriptをドキュメントで実行するには、環境設定でJavaScriptを有効にする必要があります(ユーザー設定)。

JavaScriptを有効化

  1. メニューバーのドロップダウンメニューからPDFpenPro>[環境設定]を選択します。
  2. [環境設定]ダイアログで[全般]タブを選択します。
  3. [JavaScriptを有効化]オプションをチェックします。

PDF JavaScriptの表示と編集

PDFpenProのスクリプトウィンドウでは、ドキュメントのJavaScriptを表示および編集できます。 PDFpenProで複数のドキュメントを同時に開いている場合、[スクリプト]ウィンドウには、アクティブに編集しているドキュメントのスクリプトが表示されます。

  1. メニューバーから、ドロップダウンメニューから[ウィンドウ]> [スクリプト]を選択して、スクリプトウィンドウを表示します。
  2. ドキュメントに現在含まれているすべてのJavaScriptが左側のペインに一覧表示されます。 ドキュメントスクリプトが一番上に表示されます。 各ページにあるページスクリプトを以下に示します。
  3. 左側のペインでアイテムをクリックして選択すると、右側のスクリプトエディタペインにJavaScriptが表示されます。
  4. スクリプトエディタペイン内をクリックして、スクリプトの編集を開始します。
  5. スクリプトに加えられた変更は自動的に保存されます。

注意:Adobe JavaScriptは通常、接頭辞として「AF」が付けられます。

PDF JavaScriptの削除

スクリプトウィンドウでは、PDF内のJavaScriptを削除できます。 ドキュメントに現在含まれているJavaScriptは、左側のペインに一覧表示されます。

  1. メニューバーから、ドロップダウンメニューから[ウィンドウ]> [スクリプト]を選択して、スクリプトウィンドウを表示します。
  2. ドキュメントに現在含まれているすべてのJavaScriptが左側のペインに一覧表示されます。 ドキュメントスクリプトが一番上に表示されます。 各ページのページスクリプトを以下に示します。
  3. 左側のペインでアイテムをクリックして選択すると、右側のスクリプトエディタペインにJavaScriptが表示されます。
  4. スクリプトウィンドウの左下隅にあるマイナス - をクリックして、スクリプトを削除します。
  5. スクリプトに加えられた変更は自動的に保存されます。

PDF JavaScriptの追加

スクリプトウィンドウでは、PDFに新しいスクリプトを追加できます。

  1. メニューバーから、ドロップダウンメニューから[ウィンドウ]> [スクリプト]を選択して、スクリプトウィンドウを表示します。
  2. ドキュメントに現在含まれているJavaScriptアクションは、左側のペインに一覧表示されます。 ドキュメントスクリプトが一番上に表示されます。 各ページのページスクリプトを以下に示します。
  3. スクリプトウィンドウの左下隅にあるプラス + をクリックして、新しいスクリプトを追加します。
  4. [スクリプトを追加する]ダイアログで、[スクリプトの種類の選択]ドロップダウンメニューからスクリプトの種類を選択します。
  5. フォームフィールドに注釈アクションを追加する場合は、[アクションを選択してください]ドロップダウンメニューからアクションを選択します。 フォームフィールド計算の追加については、フォームの作成を参照してください。
  6. 編集ペイン内をクリックして、デフォルトのテキスト「//ここにスクリプトを入力します」を新しいスクリプトに置き換えます。
  7. スクリプトに加えられた変更は自動的に保存されます。

注意:特定のフォームフィールドに注釈アクションを追加するには、プラス + をクリックしてスクリプトを追加する前に、フォームフィールドを選択しておく必要があります。 特定の注釈を選択していない場合は、ドキュメントまたはページスクリプトのみを追加できます。

JavaScriptの実行

JavaScriptをテストする方法はいくつかあります。 スクリプトを1行ずつ実行するには、JavaScriptウィンドウを使用します。

  1. Option(またはAlt)キーを押したままにします。
  2. [ウィンドウ]> [JavaScript コンソール]を選択します。
  3. コンソールにスクリプトを入力または貼り付けます。
  4. 実行するをクリックします。

計算を使用してフォームをテストするには、フォームを試すためにテキストの選択ツールselect tool(Command + 1)に切り替える必要があります。 フォームに配置した要素の外観を編集するには、編集ツールedit tool(Command + 2)に戻ります。

注意:JavaScriptは、次の場合にのみ正常に実行されます。

  • スクリプトが正しい。
  • スクリプトがPDFバージョンでサポートされている。
  • スクリプトがPDFpenProによってサポートされている。