ブックマーク
PDFブックマークは目次のように機能します。ブックマークを使用すると、PDFドキュメント内を簡単に移動することができます。デザインスクリプトブックマークを使用すると、PDFドキュメント内のセクション、ビュー、またはシートへのジャンプ、Webリンクへのジャンプ、音声クリップの再生を行うことや、デザインファイルから情報を抽出してブックマークを使って表示することができます。
次のタイプのブックマークを作成することができます。
ブックマークタイプ |
---|
対象領域ブックマーク |
ドキュメントブックマーク |
Webリンクブックマーク |
音声クリップブックマーク |
文字注記ブックマーク |
ブックマークはAdobe ReaderまたはAdobe Acrobatのナビゲーションペインに表示され、通常は階層構造のツリービューとして編成されます。文字注記ブックマークなど、一部のブックマークエントリには操作が関連付けられていない場合があります。そのようなブックマークはブックマーク階層の構造を形成するためのプレースホルダとして機能します。
ドキュメント内の各シートには常に親ブックマークが作成されます。親ブックマークエントリはsheet_nameキーワードの値に設定されます。親ブックマークエントリをクリックすると、シート全体が全画面表示されます。同じシートに作成されるその他のブックマークは親ブックマークの子になります。
デザインスクリプトキーワードを使用すると、ReaderまたはAcrobatビューアでドキュメント内の特定のセクションまたはビューにズームインするブックマークを作成できます。セクションやビューの範囲はデザインスクリプトの基準に一致する要素を囲む長方形の累積範囲により決定されます。ズームファクタまたは尺度は要素の累積範囲により決定され、zoom_percentageキーワードを使用してさらに調整することができます。
action_specキーワードを使用すると、ブックマーク階層内でのブックマークの位置を指定できます。詳細については、「ブックマークテンプレート」を参照してください。
対象領域ブックマーク
ドキュメント内の特定のセクションまたはビューへのブックマークを作成できます。セクションやビューの範囲はデザインスクリプトの基準に一致する要素を囲む長方形の累積範囲により決定されます。
次の表は、対象領域ブックマークを作成するときの操作キーワードの必須値と既定値を示しています。
キーワード | 値 | 既定値 |
---|---|---|
action_item | BOOKMARK | 必須 |
action_name | 「ブックマーク」タブ内でブックマークエントリを識別するための一意の文字列。 | 必須 |
action_type | AREA_OF_INTEREST | 既定値 - オプション |
action_spec | ブックマーク階層内でのブックマークの位置を指定します。値が指定されていない場合は、現在の階層の一番下にブックマークが配置されます。 | オプション |
action_range | Element_range|cell_range | Element_range |
action_instance | Single_instance|Multiple_instance | Single_instance |
次のデザインスクリプトを実行すると、デジタル署名フィールドへのブックマークが作成されます。
例:
! Create a area of interest Digital Signature Field ! The accumulated range box of the elements below ! defines the Digital Signature field in the PDF document. if ((level eq 1) and (color eq 9) and (type eq 3)) then action_item = field action_name = "Chief Engineer" action_type = digsig_field action_spec = "John Doe, P.E." ! Create a bookmark to the Digital Signature Field action_item = bookmark action_name = "Signature Field" !Bookmark name (unique) action_type = AREA_OF_INTEREST action_spec = "./digsig/engineer" endif
上のデザインスクリプト例を実行すると、次のブックマークが作成されます。
ドキュメントブックマーク
ドキュメントブックマークをクリックすると、PDFドキュメント内の特定のワークシートにジャンプできます。ドキュメント内の各シートには常に親ブックマークが作成されますが、ドキュメント内の他のシートにジャンプするブックマークを追加することもできます。
ドキュメントブックマークを作成するには、ブックマークがクリックされたときのジャンプ先となるシート名をaction_nameキーワードで指定します。sheet_nameキーワードを使用して各シートの名前を定義することもできます。
次の表は、ドキュメントブックマークを作成するときの操作キーワードが必須であるかと、その既定値を示しています。
キーワード | 値 | 既定値 |
---|---|---|
action_item | BOOKMARK | 必須 |
action_name | sheet_name(ジャンプ先のシート名を定義します。) | 必須 |
action_type | DOCUMENT | 必須 |
action_spec | ブックマーク階層内でのブックマークの位置を指定します。 | 必須 |
action_range | 適用できません | 適用できません |
action_instance | 適用できません | 適用できません |
例:
! Create a bookmark that jumps to a particular ! sheet in a document for all sheet names beginning with plan*. if (sheet_name eq "plan*") then action_item = BOOKMARK action_name = "details" ! Sheet to jump to action_type = DOCUMENT action_spec = "./Related pages/Details drawing" endif
上のデザインスクリプト例を実行すると、次のブックマークが作成されます。
Webリンクブックマーク
Webリンクブックマークをクリックすると、Webページにジャンプできます。どの種類のブックマークを作成する場合も、action_itemキーワードにbookmarkを設定する必要があります。action_nameキーワードでは、ブックマークエントリの名前ではなくURLアドレスを指定します。ブックマークエントリの名前はaction_specキーワードの最後のエントリに基づいて決定されます。たとえば、action_specキーワードで「action_spec="/Related Web Links/TDOT Standards Specifications"」と指定した場合は、TDOT Standards Specificationsがブックマークエントリの名前になります。
action_specキーワードを使用してブックマーク階層内でのブックマークの位置を指定することもできます。action_typeはweb_urlに設定する必要があります。
次の表は、Webリンクブックマークを作成するときの操作キーワードが必須であるかと、その既定値を示しています。
キーワード | 値 | 既定値 |
---|---|---|
action_item | BOOKMARK | 必須 |
action_name | URLのHTTP指定(WebリンクのURLを指定します。) | 必須 |
action_type | WEB_URL | 必須 |
action_spec | ブックマーク階層内でのブックマークの位置を指定し、ブックマークエントリの名前を定義します。 | 必須 |
action_range | 適用できません | 適用できません |
action_instance | 適用できません | 適用できません |
例:
! Create a bookmark that jumps to a Web page. ! action_item = BOOKMARK action_name = "http://www.dot.state.tx.us/cst/2003SpecProj/index.htm" action_type = WEB_URL action_spec = "./Related Web Links/TDOT Standards Specifications"
上のデザインスクリプト例を実行すると、次のWebリンクブックマークが作成されます。
音声クリップブックマーク
音声クリップブックマークをクリックすると、PDFドキュメント内の音声クリップを再生できます。どの種類のブックマークを作成する場合も、action_itemキーワードにbookmarkを設定する必要があります。
action_nameキーワードではブックマークエントリの名前ではなく音声ファイルの場所を指定します。ブックマークエントリの名前はaction_specキーワードの最後のエントリに基づいて決定されます。
音声クリップブックマークを作成するときは、action_typeキーワードにplay_soundを設定する必要があります。action_specキーワードを使用してブックマーク階層内でのブックマークの位置を指定することもできます。
次の表は、音声クリップブックマークを作成するときの操作キーワードが必須であるかと、その既定値を示しています。
キーワード | 値 | 既定値 |
---|---|---|
action_item | BOOKMARK | 必須 |
action_name | 音声ファイルの場所を指定します。 | 必須 |
action_type | PLAY_SOUND | 必須 |
action_spec | ブックマーク階層内でのブックマークの位置を指定し、ブックマークエントリの名前を定義します。 | 必須 |
action_range | 適用できません | 適用できません |
action_instance | 適用できません | 適用できません |
例:
! Create a bookmark that plays a sound clip. ! action_item = BOOKMARK action_name = "c:\my audio files\instructions.wav" action_type = PLAY_SOUND action_spec = "./Audio Instructions/Listen Before Installing!"
文字注記ブックマーク
文字注記ブックマークをクリックすると、文字情報を表示できます。文字注記ブックマークを使用すると、DGNファイルから抽出した文字情報へのブックマークを作成して文字情報を表示することができます。ブックマーク内に文字列をハードコーディングすることも、ブックマークの任意のCharactersキーワードを表示することもできます。
どの種類のブックマークを作成する場合も、action_itemキーワードにbookmarkを設定する必要があります。文字注記ブックマークの場合は、ブックマーク項目を識別するための文字列とブックマークエントリの値をaction_nameで指定します。action_typeキーワードはtext_descriptionに設定する必要があります。
action_specキーワードを使用してブックマーク階層内でのブックマークの位置を指定することもできます。
次の表は、文字注記ブックマークを作成するときの操作キーワードが必須であるかと、その既定値を示しています。
キーワード | 値 | 既定値 |
---|---|---|
action_item | BOOKMARK | 必須 |
action_name | このブックマーク項目を識別するための一意の文字列。この値が新しいブックマークエントリとして使用されます。 | 必須 |
action_type | TEXT_DESCRIPTION | 既定値 - オプション |
action_spec | ブックマーク階層内でのブックマークの位置を指定します。値が指定されていない場合は、現在の階層の一番下にブックマークが配置されます。 | オプション |
action_range | 適用できません | 適用できません |
action_instance | 適用できません | 適用できません |
次のデザインスクリプトを実行すると、図面のタイトルブロックから抽出したシートの説明を表示するブックマークが作成されます。
例1:
! Display the sheet description from the title block. ! if (type .eq. text) then if ((level_name .eq. "titleblock") and (weight .eq. 1)) then ! Create a text description bookmark action_item = BOOKMARK action_name = characters !Text string from the drawing. action_type = text_description action_spec = "./Description" endif endif
上のデザインスクリプト例を実行すると、次の文字注記ブックマークが作成されます。
次のデザインスクリプトを実行すると、ドキュメント内のシートの数を表示するブックマークが作成されます。
例2:
! Use a bookmark to display the number of sheets ! in the document. if (sheet_name eq "index of sheets") then ! Create a text description bookmark action_item = BOOKMARK action_name = total_pages action_type = TEXT_DESCRIPTION action_spec = "./Number of pages in document" endif
ブックマークテンプレート
ブックマーク階層のレイアウトを定義するXMLファイルを作成できます。bookmark_templateキーワードでXMLファイルの場所を指定します。たとえば、「bookmark_template = "d:\anystreet\book.xml"」のように指定します。
action_specキーワードを使用すると、ブックマーク階層内でのブックマークの位置を指定できます。action_specの値ではブックマークの階層ブランチの名前を指定し、各ブランチ名をスラッシュ文字(/)で区切ります。ピリオド文字(.)はルートまたはブックマーク階層の最上位を表します(「"./ブランチ名1/ブランチ名2/ブランチ名3"」のように指定します)。
ブックマークテンプレートを使用する場合、テンプレート内で定義されていないブランチ名が検出されるまでaction_specの値に含まれる各ブランチ名が(左から右の順に)各ブックマークテンプレートのタイトルと比較されます。定義されていないブランチ名が見つかった場合は、指定されたブランチ名を使用して新しいブランチが作成されます。以下に示すブックマークテンプレートの例を使用してaction_specを「./StormWater/Pit15/MyBookmark」に設定した場合、次のブックマークが作成されます。
Storm Water System 1.2 Kerb Opening (PIT15) MyBookmark
空の階層ブランチはブックマークツリーから削除されます。ただし、XML要素内でXML属性KeepAlwaysの値を1に設定すると、このような空の階層ブランチを保持できます。この機能を使用すると、Acrobat Professionalで後から値を設定したり編集したりすることができるようにブックマーク構造を定義できます。
ブックマークテンプレートファイルの例:
<?xml version="1.0" encoding="UTF-8" ?> <bookmark-tree> <bookmark title="WasteWater">Waste Water Supply</bookmark> <bookmark title="WaterSupply">Water Supply System</bookmark> <bookmark title="StormWater">Storm Water System <bookmark title="PIT12">1.2 Kerb Opening (PIT12)</bookmark> <bookmark title="PIT13">1.2 Kerb Opening (PIT13)</bookmark> <bookmark title="PIT14">1.2 Kerb Opening (PIT14)</bookmark> <bookmark title="PIT15">1.2 Kerb Opening (PIT15)</bookmark> <bookmark title="PIT16">1.2 Kerb Opening (PIT16)</bookmark> <bookmark title="PIT17">1.2 Kerb Opening (PIT17)</bookmark> <bookmark title="PIT18">1.2 Kerb Opening (PIT18)</bookmark> <bookmark title="PIT19">1.2 Kerb Opening (PIT19)</bookmark> <bookmark title="PIT20" KeepAlways="1">1.2 Kerb Opening (PIT20)</bookmark> </bookmark> <bookmark title="digsig">Digital Signatures <bookmark title="engineer">Project Engineer</bookmark> <bookmark title="project">Project Manager</bookmark> </bookmark> </bookmark-tree>