サイトマップ

▼ サイトの紹介

このサイトはExcel VBAから、Acrobat  アプリケーションをプログラミング操作するOLE機能について解説しています。

Adobe社はこのOLE機能の事を「IAC」と表現しています。

(注意:Adobe Readerだけでは使用出来ません)

Adobe社提供のSDK資料を元にサンプルを加えて説明をしています。

サイト管理人もご覧下さい。

▼ 当サイトの使い方

当サイトをうまく使う上での手順を以下に示します。

  1. 最初に「Acrobat SDK:OLE objects and methods図を入手する」にあるオブジェクト連携図を手に入れます。出来れば印刷する方が見やすいです。1頁です。
  2. 下記の「Excel」、「Acrobat」、「ダウンロード」、「SDK」、「備考」にサッと目を通します。「その他&メモ」は特に見なくてもイイです。
  3. 自分が目的とする処理を探しながら、印刷したオブジェクト連携図を元にサイト記「Object & List」下を上からクリックしてザックリと内容を見ます。各オブジェクトのメソッドの詳細は後にして全体で何が出来て、何が出来ない(サポートされていない)かを把握します。
    Acobat OLE 以外の選択」も見て下さい。
  4. 目的が解決出来ない時は、キッパリとあきらめてAdobe社の日本語「Acrobat アドビフォーラム」で相談します。 ココ ↓
    http://forums.adobe.com/community/international_forums/japanese/acrobat
    当サイト pdf-file.nnn2.com より質が高い。
  5. それでもダメなら、当サイトにコメントを入れてみます。サイト管理人がある程度、判る範囲でお答えをします。
    (お願い:管理人を「様」での呼び方はご遠慮下さい。管理人さ~んで十分です。)

▼ Excel

  1. Excel からAcrobatを操作する訳
  2. Excel から PDFファイル を作成&操作出来る
  3. Excel のオブジェクトブラウザ
  4. Excel からAcrobatを起動する
  5. Excel からPDFファイルを起動表示する
  6. Excel サンプル:PDFの文書プロパティを表示する
  7. 上記7のサンプルファイルの実行エラー
  8. Excel VBA 実行エラー時のメッセージ
  1. Excel でOLEの参照設定をする
  2. Excel でOLEの参照設定をする (AFormAut の追加)
  3. Excel でOLEの参照設定をする (Stream の追加)
  4. Excel でOLEの参照設定をする (MSXMLの追加)

▼ Acrobat

  1. Acrobat SDK:OLE objects and methods図を入手する
    ここで示す図は必ず入手する必要があります。
    これが無いとオブジェクト連携が判らなく、OLE(IAC)操作が出来ません。
  2. Acrobatアプリケーションを閉じる(実は簡単に出来ない)
  3. Acrobat OLE 使用上の注意事項
  4. Acrobatプログラミングにおける技術上の制約やライセンス上の制約
  5. PDFファイルを作成、及び操作する開発者に対しての注意事項
  6. Windows のコマンドラインから Acrobat や Adobe Reader を使用して印刷する方法
  7. PDFドキュメントの文書フラグとは
  8. PDF バージョンとは
  9. PDFバージョンの変化
  10. ExportTask.xml
  11. 一括で複数ファイルを処理(アクション、バッチ処理)
  12. PDF の3つのパスワード
  13. PDFのパスワードは32文字まで
  14. 印刷の問題点を解決
  15. PDF内での座標の起点
  16. Acrobatとレジストリ
  17. PDF上のテキストと座標を取得

▼ ダウンロード

  1. 各種サンプルのダウンロード
  2. Adobe Acrobat 9.1 SDK のダウンロード
    SDKをダウンロードしてサンプル、解説PDF,HTML等を入手する必要があります。
    Adobe Acrobat X SDK のダウンロード情報も入ってます。
  3. Adobe Acrobat 8.1 SDK のダウンロード
    この 8.1 バージョンのSDKは現時点(2013/10/03)で一般公開されてません。
    情報が入り次第、掲載します。
  4. Acrobat製品別ダウンロード先 URL
  5. AcroPDFLib.AxAcroPDF:Excel VBAサンプル(A)
  6. AcroPDFLib.AxAcroPDF:Excel VBAサンプル(B)
  7. Adobe Readerの各種バージョンのダウンロード

▼ SDK

  1. AcrobatプログラミングにおけるMenu and Toolbar Button Names 一覧
  2. PDDocのGetJsObjectのオブジェクト構造図が見当たらない
  3. Acrobat SDK:正誤表
    Acrobat SDK v8.1ドキュメントに記載ミスが有ります。
  4. Acrobatに関するSDKが Acrobat Developer Center からダウンロード出来ます。
  5. Acrobat JavaScript における「Safe Path:セーフパス」についての注意事項
  6. Acrobat SDK公開Webサイト URLの取得方法

▼ 備考

  1. JavaScriptの解説はAcrobat v7 v8 共に英語版です。しかし、旧バージョンですがコメントを頂いた方から日本語版のAcrobat JavaScript解説PDFが見つかりました。以下がそのPDFです。
    http://www.adobe.com/jp/support/products/pdfs/acrojs_j.pdf
  2. [2009/1/7] AcroExch.AVDoc:Open メソッド でバグ?を発見しました。Acrobat v8.1.3 v9.0が対象です。

 

▼ その他&メモ

  1. OCR機能:読んde!ココと比較した結果
  2. アドビ(Adobe)製品に関するRSSの情報
  3. 添付ファイルの扱いには注意が必要
  4. AcrobatはPDF作成ソフトの標準では無くなる?
  5. Acrobat PDF は国際標準化された
  6. 手書きPDF入門」 リンク
  7. planet pdf (PDF関連の英語サイト) リンク
  8. デフォルトプリンタを一時的に変更する方法
  9. Delphi(デルファイ,デルフィ)言語からの使用方法
  10. Acrobat使用時のレジストリ変化を取得する方法
  11. オブジェクトは値では無く、参照情報を持つ
  12. Adobe Reader で PDF ファイルを表示 / 印刷する方法
  13. サンプル:RGB値の一覧(カラー番号)
  14. 「・・このバージョンの Acrobat ではサポートされていない新しい形式・・」警告メッセージへの対応

▼日本語の資料

日本語版で公開されている技術情報が非常に少なく、また対応バージョンも古く、作成年度も古いのが多いです。しかし、PDF 又はAcrobat のエンジニア向けの基本的な技術はこの10年間はそれ程進歩していません。よって思った以上に使える事に気がつくはずです。

公開されている情報は今後消滅すると予想されます。必要な情報はバックアップする事をお勧めします。

▼ Acrobat SDK 関連

  1. Acrobat JavaScript Object Specification バージョン 5.0.5
    テクニカルノート# 5186 改訂日:2001年9月14日
    (297頁) Acrobat 5.0 JavaScript リファレンスマニュアル。
    PDF ドキュメントでJavaScript を使用するために必要なすべての情報。
    ※2018/10 リンク先は消滅しました。
  2. Developing Acrobat Applications Using JavaScript
    Adobe Acrobat SDK バージョン 8.0

    (220頁) JavaScript を使用してAdobe Acrobat での開発や拡張したりする方法について
    説明したマニュアル。必読!
  3. JavaScript for Acrobat 3D Annotations API Reference
    Adobe Acrobat SDK 2007年4月バージョン 8.1

    (105頁) 3D 機能(3D注釈のJavaScript API)をユーザに提供したい開発者を対象にしたマニュアル
  4. Parameters for Opening PDF Files(日本語版)
    Adobe Acrobat SDK Version 8.1 April 2007

    (8頁) PDF ファイルをURL やコマンドの中で開く際に使用できるパラメータについて説明したマニュアル
  5. Adobe Acrobat Workshop
    (78頁) Acrobat 7.0 JavaScript、API、IAC等の開発環境に関する概念の説明図
  6. Adobe Acrobat 7.0 Acrobat JavaScript Scripting Guide 2005年1月7日
    (276頁) Acrobat JavaScript を使用して開発したり拡張したりする方法について簡単に説明ししたもの
  7. Programming Acrobat JavaScript Using Visual Basic
    Technical Note #5417 バージョン:Acrobat 6.0 2003年5月

    (14頁) Acrobat 6.0 提供のJSObject と言うOLE オートメーション機能のプログラミング環境に関しての概念を説明したもの
  8. Acrobat JavaScript Scripting Guide
    Technical Note #5430 バージョン:Acrobat 6.0 2003年5月

    (90頁) Acrobat 6 Pro に搭載されている JavaScript 開発環境を使用して Acrobat アプリケーションを開発したり拡張したりする方法を簡単にまとめたもの
  9. Upgrading Plug-ins From Acrobat 5 to Acrobat 6
    Technical Note #5424 バージョン:Acrobat 6.0 2003年7月

    (28頁) Acrobat 6 API の概要を説明し、Acrobat 5 およびそれ以前のプラグインを Acrobat 6 にアップグレードする際に開発者が理解しておくべきことについて説明したマニュアル
  10. Adobe® Solutions Network Developer Program FAQ for Members
    Version 3.0 MAY 2002

    (461頁) ASNディベロッパーサポートプログラム会員から頂いたAcrobat Plug-in API,IAC,Readerに関する質問を整理した情報
  11. Acrobat Developer FAQ
    Adobe Developer Relations 改定:1999年9月2日

    (37頁) 質問および回答形式を整理した情報
  12. Parameters for Opening PDF Files(日本語版)
    Adobe Acrobat SDK Version 8.1 April 2007

    (24頁) Acrobat SDK でよくある質問と回答を整理したもの
  13. Adobe Acrobat 7.0 Acrobat SDK ユーザガイド 2004年12月14日
    (124頁) Acrobat SDKで提供されている機能、Acrobatで提供されている機能とその操作説明等
  14. JavaScript for Acrobat API Reference
    Adobe Acrobat SDK バージョン 8.0

    (765頁) Acrobat JavaScript の詳細な解説書/リファレンス

▼ Acrobat 一般資料

  1. Adobe Acrobat Security ディベロッパーサポート 2005年4月7日
    (43頁) Acrobat 7.0 の各種セキュリティに関する概念

管理人の独り言

  • 2010/4/26 「Appメソッド一覧」移行完了。かなり見直したので、結構解説が難しくなってしまったかも・・。全部の移行が完了したら、再度見直す事にして、次に行きます。
  • 2010/5/14 データの移行と再リンクが終わりました(汗)。サイトマップの構成も少し見直して・・。後は見直し(リニューアル)する必要有り。OLE(IAC)の全貌が判った時点で細かい部分の追加が必要となった。各頁にかなりの追加と再テストが必要だが既に環境は出来あがっている。本当の踏ん張ると事はココからかもしれない。
  • 2010/5/18 Appオブジェクトの移行が完了しました。
  • 2012/11/12 AFormAut オブジェクトが IAC に含まれていない盲点に orz
  • 2013/10/14 JavaScriptAPIと言う当サイト独自の表現を JSObject と本来の表現に変更する。
  • 2015/5/9 サイトのレイアウトを変更。

▼ Acobat OLE 以外の選択

Adobe Acrobat OLE(IAC)以外で、PDFファイルをプログラミング操作する情報を以下に提供します。

VBA の Shell 関数(又はWscriptのExec関数)で起動する事により、IACには無い機能で複数ファイルの自動化処理が可能だと思われます。

  1. Qpdf
    PDF をコマンドラインで操作するツール
    セキュリティ(パスワード)の設定が出来る!
  2. Poppler
    PDF をコマンドラインで操作するツール
    Xpdf をペースした機能拡張版
    注意:公式サイトからはWin版EXEは配布されてません。
  3. pdf2htmlEX
    PDF をHTMLへ変換する高性能なツール
  4. Coherent PDF Command Line Tools
    非常に多機能なコマンドラインツール
    ライセンスに注意が必要
  5. Xpdf
    PDF をコマンドラインで操作するツール
    Popplerの旧バージョン。安定版。
  6. PDFtk *  ※検証予定(時期未定)
    PDF をコマンドラインで操作するツール  
  7. PDFill PDF Writer: PDF作成ツール
    コマンドラインの使用は有償版のみ。
    無償版と有償版。表示は英語。
  8. ★その他の各種ソフトとツール★
    各種のPDFソフトウェアを一覧でまとめたサイトです。
    たぶん、ココの情報が最新で内容も充実してると思われます。

[コメント入力] <-をクリックするとページの最後にコメント入力が出来ます。
名前(ニックネーム)は必須。メールアドレス(非表示)も必須ですが、適当で結構です。

【更新日:2019/06/05 (11版)】

テキストにリンクを追加

TOP > サンプル / 関数 > *      [...]


相馬野馬追@TCK

 

概要

PDFの指定テキストに以下のリンクを追加します。

  1. PDF内のページ移動
  2. 他のPDFファイルを開く
  3. Webページを開く

処理方法は大きく2つです。

  1. 指定テキストのページ番号と座標を取得
  2. その情報でリンクを追加する為のAcrobat JavaScriptを実行

共にVBAからAcrobat OLE経由でAcrobat JavaScriptを実行して処理をします。

 

関数の利用

関数:文字列検索でページ番号と座標を返す」で紹介している関数: GetTextsGetRects を使用して、文字列検索をさせ、そのページ番号と座標を取得します。その結果を使ってリンクを追加します。

 

サンプル

テキストを検索し、それに以下のリンクを設定します。

  • "マニュアルを参照": ABC.pdfを開く
  • "PDF": pdf-file.nnn2.comを開く
  • "目次の先頭": ページ番号=2へ移動

以下は実行するAcrobat JavaScriptのサンプルです。

001 var link = this.addLink(0, [200,200,400,300]); 002 link.setAction( "this.pageNum = 9"); 003 link.borderColor = color.red; 004 link.borderWidth = 1;

 

参照設定が2つ必要です。

ダウンロード:sample-AddLinkTexts.xls

 

 

001 Option Explicit 002 003 '************************************************** 004 ' 005 ' サンプル:テキストにリンクを追加 006 ' 007 ' 008 '************************************************** 009 010 Sub Sample_AddLinkTexts() 011 012 Dim start As Double: start = Timer 013 Debug.Print "Sample_AddLinkTexts " & Time 014 015 Dim bRet As Boolean 016 Dim sFilePathIn As String 017 Dim sFilePathOut As String 018 Dim lOutData(100, 5) As Long 019 Dim iOutCnt As Long 020 Dim i1 As Long 021 Dim sInSerchText() As String 022 Dim sAction() As String 023 ReDim sInSerchText(2) As String 024 ReDim sAction(2) As String 025 026 '初期化 027 i1 = 0 028 ' 検索テキスト 029 sInSerchText(i1) = "マニュアルを参照" 030 ' リンクで動作するAcrobat JavaScript 031 sAction(i1) = "app.openDoc('/D/ABC/xyz.pdf');" 032 'sAction(i1) = "app.openDoc('/I//サンプル/test-001.pdf');" 033 i1 = i1 + 1 034 sInSerchText(i1) = "PDF" 035 sAction(i1) = "this.getURL('https://pdf-file.nnn2.com/');" 036 i1 = i1 + 1 037 sInSerchText(i1) = "目次の先頭" 038 sAction(i1) = "this.pageNum=3;" 039 040 '▼テキストを検索し、ページ番号と座標を得る 041 sFilePathIn = ThisWorkbook.Path & "\test-003.pdf" 042 'See URL. https://pdf-file.nnn2.com/?p=1099 043 bRet = GetTextsGetRects(sFilePathIn, -1, -1, _ 044 sInSerchText, lOutData, iOutCnt) 045 046 '▼リンクを追加する 047 048 Dim objAcroApp As New Acrobat.AcroApp 049 Dim objAcroAVDoc As New Acrobat.AcroAVDoc 050 Dim objAcroPDDoc As New Acrobat.AcroPDDoc 051 Dim objAcroPDPage As Acrobat.AcroPDPage 052 Dim objAcroPoint As Acrobat.AcroPoint 053 Dim objAcroHiliteList As New Acrobat.AcroHiliteList 054 Dim objAcroAVPageView As Acrobat.AcroAVPageView 055 Dim objAcroPDTextSelect As Acrobat.AcroPDTextSelect 056 Dim objAcroRect As Acrobat.AcroRect 057 Dim objAFormApp As AFORMAUTLib.AFormApp 058 Dim objAFormFields As AFORMAUTLib.Fields 059 060 objAcroApp.CloseAllDocs 061 objAcroApp.Hide '稀に表示されるので隠す 062 063 'PDFファイルを開く 064 bRet = objAcroAVDoc.Open(sFilePathIn, "") 065 066 Set objAcroPDDoc = objAcroAVDoc.GetPDDoc 067 Set objAFormApp = CreateObject("AFormAut.App") 068 Set objAFormFields = objAFormApp.Fields 069 Set objAcroPDDoc = objAcroAVDoc.GetPDDoc 070 071 Dim sAJS As String 072 Dim sReturn As String '未使用 073 074 Const sAcrobatJavaScript As String = _ 075 "var link = this.addLink(@P, [@1,@2,@3,@4]) ;" & _ 076 "link.setAction(""@A"") ;" & _ 077 "link.borderColor = @C ;" & _ 078 "link.borderWidth = @W ;" 079 080 For i1 = 0 To iOutCnt 081 If lOutData(i1, 0) = -1 Then Exit For 082 Debug.Print "Text(" & i1 & ")=" & _ 083 sInSerchText(lOutData(i1, eOut.Index)) & _ 084 " Index=" & lOutData(i1, eOut.Index) & _ 085 " Page=" & lOutData(i1, eOut.Page) & _ 086 " Top=" & lOutData(i1, eOut.Top) & _ 087 " Bottom=" & lOutData(i1, eOut.bottom) & _ 088 " Left=" & lOutData(i1, eOut.Left) & _ 089 " Right=" & lOutData(i1, eOut.Right) 090 091 'Acrobat JavaScriptの編集 092 sAJS = sAcrobatJavaScript 093 sAJS = Replace(sAJS, "@P", lOutData(i1, eOut.Page)) 094 sAJS = Replace(sAJS, "@1", lOutData(i1, eOut.Left)) 095 sAJS = Replace(sAJS, "@2", lOutData(i1, eOut.Top)) 096 sAJS = Replace(sAJS, "@3", lOutData(i1, eOut.Right)) 097 sAJS = Replace(sAJS, "@4", lOutData(i1, eOut.bottom)) 098 sAJS = Replace(sAJS, "@A", sAction(lOutData(i1, eOut.Index))) 099 sAJS = Replace(sAJS, "@C", "color.blue") 100 sAJS = Replace(sAJS, "@W", 1) 101 102 'Acrobat JavaScript の実行 103 sReturn = objAFormFields.ExecuteThisJavascript(sAJS) 104 Next i1 105 106 'PDFファイルを別名で保存 107 sFilePathOut = Replace(sFilePathIn, ".pdf", "-New.pdf") 108 If objAcroPDDoc.Save(1, sFilePathOut) = False Then 109 MsgBox "PDFファイルへ保存出来ませんでした", _ 110 vbOKOnly + vbCritical, "実行エラー" 111 End If 112 113 '変更しないで閉じます。 114 bRet = objAcroAVDoc.Close(False) 115 116 'Acrobatアプリケーションの終了 117 objAcroApp.Hide 118 objAcroApp.Exit 119 120 'オブジェクトの開放 121 Set objAcroHiliteList = Nothing 122 Set objAcroAVPageView = Nothing 123 Set objAcroPDTextSelect = Nothing 124 Set objAcroRect = Nothing 125 Set objAcroPDPage = Nothing 126 Set objAcroPoint = Nothing 127 Set objAcroPDDoc = Nothing 128 Set objAcroAVDoc = Nothing 129 Set objAFormApp = Nothing 130 Set objAFormFields = Nothing 131 Set objAcroApp = Nothing 132 133 Debug.Print "出力件数 = " & iOutCnt 134 Debug.Print "処理時間 = " & Timer - start 135 End Sub


 Highlight:プログラミング言語のソースコードを構文で色分け (GUI編)
 

関数: GetTextsGetRects のソースはコチラから持ってきてください。

 

実行結果

実行前です。

実行後です。

以下のリンク動作は正常に確認できました。

  • "マニュアルを参照": ABC.pdfを開く
  • "PDF": pdf-file.nnn2.comを開く
  • "目次の先頭": ページ番号=2へ移動

 

Acrobat JavaScriptの説明

リンクを追加するAcrobat JavaScriptの各命令(メソッドとプロパティ)の説明です。

特に深く理解する必要は無いです。サンプルのやり方を真似るだけで結構です。

ココでの説明はメーカーのマニュアル「JavaScript™ for Acrobat® API Reference Adobe® Acrobat® SDK バージョン 8.0」とは異なり、Acrobat JavaScript専用の表現を無くしています。説明も関係する部分のみとしました。

*AD:ネット公開されている上記の日本語マニュアルを表示します。

 

1. addLink( nPage , [ Left , Top , Right , Bottom ] )

指定したページに、指定した座標で新しいリンクを追加します。位置情報のみを指定します。( *AD )

  • nPage:リンクを追加するページ番号。1ページ目は 0 です。
  • Left:座標Leftの値
  • Top:座標Topの値
  • Right:座標Rightの値
  • Bottom:座標Bottomの値

 

2. setAction

動作を示すAcrobat JavaScript コードを指定します。今回のリンクに関連する動作としては以下の3つが有ります。( *AD )

  1. PDF内のページ移動
    • 例:3ページ目に移動する。
      setAction( "this.pageNum = 2;" );
    • ページ番号の先頭は0です。
    • 次ページへの移動は
      setAction( "this.pageNum++;" );
       
  2. 他のPDFファイルを開く
    • 例:D:¥ABC¥xyz.pdf を開く。
      setAction( "app.openDoc( '/D/ABC/xyz.pdf ' );" );
    • パスはWindowsのパスでは無く、上記のような形式にします。
    • フォルダ名に日本語が入ってもOKです。
    • パスはシングルクォーテーション「'」で囲みます。
       
  3. Webページを開く
    • 例: pdf-file.nnn2.com を開く。
      setAction(" this.getURL( 'https://pdf-file.nnn2.com/' ); ");
    • URLはシングルクォーテーション「'」で囲みます。
       

 

3. borderColor

リンクの境界線の色を指定します。( *AD )

例:borderColor = color.red;

  • 白:color.white
  • 赤:color.red
  • 緑:color.green
  • 青:color.blue
  • シアン:color.cyan
  • マゼンタ:color.magenta
  • イエロー:color.yellow
  • ダークグレー:color.dkGray
  • グレー:color.gray
  • ライトグレー:color.ltGray

他の色を使いたい時はRGBやCMYKで指定してください。詳細はマニュアルを御覧ください。

 

4. borderWidth

リンクの境界線の幅を指定します。 ( *AD )

例:borderWidth = 1 ;

  • 0:なし
  • 1:細
  • 2:標準
  • 3:太

 

5. highlightMode

リンクの領域内でマウスボタンを押したときに使用する視覚効果を設定します。混乱させないためにもデフォルトの方がユーザーにはイイです。( *AD )

  • None:効果なし
  • Invert ( デフォルト):
  • Outline:アウトライン
  • Push:プッシュ

 

6. rect

リンクの矩形を表す 4 つの数値配列です。左上隅のx 座標、左上隅のy 座標、右下隅のx 座標、右下隅のy 座標を配列「[ Left , Top , Right , Bottom ]」を表します。( *AD )

例:今回は直に配列で指定するので省略。

 

備考

  • 処理時間は掛かります。業務での使用時はSSDなどの高速な環境をご用意ください。

 

参照

 

VBA(Excel)からAcrobat経由でPDFをプログラミング操作(OLE:IAC)する