.NET/COM プログラムから PDF の編集や操作を可能にするライブラリ

ActivePDF Toolkit で PDF の作成、編集

ActivePDF Toolkit は、ソフトウェア開発者向けの PDF 処理用のライブラリです。シンプルで直感的な .NET および COM インターフェイスを通じて、大部分の PDF 作成・編集作業の動的な処理が可能になります。

PDF ファイルへの認証、すかしの追加、Flash ファイルの埋め込み、フォーム フィールドの作成、ヘッダー/ フッターの作成、ページの抽出や結合、コメントの追加、その他にも多数の PDF ファイルへの操作を ActivePDF Toolkit で簡単に行うことができます。

Toolkit Ultimate は、Toolkit のすべての機能に加えて、画像のラスタライズ、PDF ファイルサイズの削減、機密データの編集、PDF ファイル内のデータの検索と抽出を行う SDK テクノロジーが含まれた、より強力な機能を備えたツールキットです。

  // オブジェクトのインスタンス化
  APToolkitNET.Toolkit oTK = new APToolkitNET.Toolkit(@"C:\Program Files\ActivePDF\Toolkit\bin\x64")
  
  // 新しい PDF ファイルの作成
  intOutFile = oTK.OpenOutputFile("new.pdf");
  
  // 新しいページの作成
  oTK.NewPage();
  
  // 文字列のフォントと場所を指定して追加
  oTK.SetFont("Helvetica", 24);
  oTK.PrintText(72, 720, "Hello World!");
  
  // 貼り付ける画像の場所を指定して追加
  oTK.PrintJPEG("IMG.jpg", 72, 144, 0, 0, 0);
  
  // 新しいファイルを閉じて、PDF 作成完了
  oTK.CloseOutputFile();
              

ActivePDF Toolkit のリリース情報

ActivePDF Toolkit 11.4.3 リリース (2023/8/7)

ActivePDF Toolkit 11.4.1 リリース (2022/6/15)

ActivePDF Toolkit 11.3.0 リリース (2021/11/02)

ActivePDF Toolkit 11.2.0 リリース (2021/09/08)

ActivePDF Toolkit 11.1.0 リリース (2021/05/24)

ActivePDF Toolkit 10.3.0 リリース (2020/10/23)

ActivePDF Toolkit 10.2.0 リリース (2020/5/11)

ActivePDF Toolkit 10.1.0 リリース (2019/12/5)

ActivePDF Toolkit Ultimate リリース (2019/9/15)

従来の ActivePDF Toolkit の機能に加え、これまで別製品だった Rasterizer, Redactor, Spooler, Xtractor の機能が加わった Toolkit Ultimate がリリースされました。

ActivePDF Toolkit 9.1.0 リリース (2019/7/15)

ActivePDF Toolkit 8.1.5 リリース (2019/3/28)

ActivePDF Toolkit 8.1.4 リリース (2019/1/14)

このリリースでは、フォームフィールドに関連する 2 つのメソッド (RotateField および DeleteFormFieldByID) が追加されました。また、パスワード保護されたファイルの処理の戻り値が改善されています。詳細は製品の リリースノートをご参照ください。

ActivePDF Toolkit 8.1.3 リリース (2018/9/10)

このリリースでは、過去に報告された問題の修正が主な改善点となっています。詳細は製品の リリースノートをご参照ください。

ActivePDF Toolkit 8.1.2 リリース (2018/6/18)

このリリースでは、過去に報告された問題の修正が主な改善点となっています。詳細は製品の リリースノートをご参照ください。

ActivePDF Toolkit 8.1.1 リリース (2018/3/26)

このリリースでは、以下の機能強化と過去に報告された問題の修正が主な改善点となっています。詳細は製品の リリースノートをご参照ください。

• フィールドの回転: フィールド内のテキストの向きではなく、フィールド自身を回転できるようになりました。
• SetOutputArtBox, SetOutputBleedBox, および SetOutputTrimBox のオプションのページ番号が、その他の SetOutput メソッドと一致するようになりました。
• NumPages で、パスワード付きの PDF ファイルのページ数を取得できるようになりました。
• JPEG 2000 画像に対応しました。

ActivePDF Toolkit 8.1.0 リリース (2018/1/29)

製品のバージョン表記が変更となりました。このリリースでは、過去に報告された問題の修正とパフォーマンス向上のための内部のコーディングが更新されています。詳細は製品の リリースノートをご参照ください。

ActivePDF Toolkit 2018 R1.0 リリース (2017/11/20)

ActivePDF Toolkit 2018 R1.0 では、以下の機能が追加されています。リリース情報については、製品の リリースノートからもご確認いただけます。

ActivePDF Toolkit 2017 R1.2 リリース (2017/9/5)

ActivePDF Toolkit 2017 R1.2 では、過去に報告された問題の修正が主な改善点となっています。詳細は製品の リリースノートをご参照ください。

ActivePDF Toolkit 2017 R1.1 リリース (2017/7/7)

ActivePDF Toolkit 2017 R1.1 では、過去に報告された問題の修正が主な改善点となっています。詳細は製品の リリースノートをご参照ください。

ActivePDF Toolkit 2017 R1.0 リリース (2017/4/24)

ActivePDF Toolkit 2017 R1.0 では、以下の機能が追加されています。リリース情報については、製品の リリースノートからもご確認いただけます。

一部エディションの販売終息について

製品の開発元の意向により、2012年 2月 29日をもちまして、ActivePDF Toolkit Standard の販売は終息となりました。

開発元の定めるエンド オブ ライフ ポリシーにより、販売終息発表後、6ヶ月間 (2012/8/21 まで) は、製品のメンテナンス リリース、パッチ、バグ修正がリリースされた場合は、これまで通り無償で提供され、販売終息発表後 1 年間 (2013/2/21 まで) は、引き続き製品のテクニカル サポートが提供されます。 なお、これらのサービスをご利用いただくには、有効なサブスクリプションが必要となります。後継製品は、以下の通りです。

ActivePDF Toolkit Professional では、Standard で利用できる全てのメソッドおよびプロパティを利用することができます。Professional へアップグレードいただくことにより、使用可能なメソッドおよびプロパティが増えます。Professional でのみ使用可能なコールの詳細は、製品の API リファレンス「Calls Available in Toolkit Pro」をご参照ください。

また、現在の最新版である ActivePDF Toolkit 2011 では、Standard と Professional は、同じインストーラーで提供され、入力するシリアル番号により、エディションが切り替わる仕組みとなっています。その為、Standard から Professional へアップグレードした場合も、製品の再インストールなしに、Standard で使用していたメソッドやプロパティをそのままご利用いただけます。

動的な PDF フォームの作成と編集

ActivePDF Toolkit では、フォーム フィールドを作成したり、カスタム PDF テンプレートにデータベースからの情報を動的に流し込むことが可能です。 更に、Toolkit のフォーム入力機能を使用することで、XML を含むデータソースからのデータを動的にフォーム フィールドに挿入できます。 また、ActivePDF Toolkit では、ユーザが画像をフォーム フィールドに追加することも可能です。画像の配置位置やサイズも簡単な操作で思いのままに指定できます。 Toolkit のフォームの単層化機能では、不必要なフォームを削除して、コンテンツだけを残します。これにより、ファイルサイズを大幅に縮小できます。

製品機能

 

Set font (フォントの設定)
テキスト、画像の PDF 出力
用紙サイズの指定
COM インターフェース
Base14 フォント & TrueType フォント サポート
表示設定の指定
メモリ・ディスクへの書き出し
描画オブジェクト サポート
重複したオブジェクトの削除
ダブル バイト文字サポート (一部) *
JPEG ファイルを PDF ファイルへ変換
フォーム フィールドの値の取得 *
TIFF を PDF ファイルへ変換
PostScript フォント サポート
他の PDF を透かしとして埋め込む
40 bit RC4 /128 bit RC4 暗号化
128 bit AES / 256 bit AES 暗号化
PDF ページの追加と抽出
ページ番号などのテキストを PDF へ追加
しおりの作成
Text2PDF インターフェース

 

PDF フォーム フィールドの作成と編集 *
メモリ・ディスクからの PDF の追加/結合/分割
メモリ・ディスクから画像を使用
PDF フォーム フィールドの埋め込み
データベースからの値をフォームに入力
PDF フォーム フィールドの追加
コンボ ボックスの値を設定
ヘッダ・フッタの追加
PDF へスタンプを追加
バーコード対応
PDF ファイルから Meta データを抽出
フィールド情報の取得 (name, javascript, など)
PDF バージョン 1.2、1.3、1.4、1.5、1.6、1.7 のサポート
コメントの追加・抽出
リニアライズ (転送バイトのセーブ)
40 種類以上の画像ファイルを PDF に変換
ステッチ機能
フォームへの XML データの挿入・抽出
電子認証
Flash ファイルの埋め込み
フィールド情報の設定

※ フォームフィールドでのダブルバイト フォントの対応については、ご購入前に評価版にて動作の確認をお願い致します。

ActivePDF Toolkit 11.1.0 のシステム要件

最新版のシステム要件は、 製品のリリースノートでご確認ください。

オペレーティング システム

注意 Toolkit 2017 およびそれ以降のバージョンを Windows Server 2012 にインストールする場合、Windows Server 2012 用の 2 つの Microsoft Update ( KB2919442 (Windows8.1-KB2919442-x64.msu) および KB2919355 (clearcompresssionflag.exe および Windows8.1-KB2919355-x64.msu)) を適用する必要があります。詳細は こちらのページをご参照ください。

※ リモート デスクトップ サービス (RDS)、ターミナル サービス、および Citrix 環境で使用される場合は、製品のご購入前に評価版で十分な動作確認を行ってください。

Toolkit の機能をリモートデスクトップを通じて使用することは可能ですが、ユーザー独自のアプリケーションで、ネットワークを通じて Toolkit の DLL へアクセスするといった使用方法では、Toolkit は機能しない場合があります。この場合、各クライアントマシンへ Toolkit をインストールする必要があり、ライセンスも必要になります。

最小ハードウェア要件

• 125 MB 以上の RAM
• 100 MB 以上のハードディスクの空き容量 (アプリケーション用)

その他

• Toolkit の .NET コンポーネントを使用する場合は、Microsoft .NET Framework 4.5 以上が必要です。
• Visual Studio C++ 2015 Redistributable

ActivePDF Toolkit の製品ドキュメント

•   ActivePDF Toolkit データシート (日本語) - PDF 形式  
•   ActivePDF Toolkit リリースノート (日本語)
•   ActivePDF Toolkit リリースノート (英語)
•   ActivePDF Toolkit API リファレンス (英語)
•   ActivePDF Toolkit 以前のバージョンのユーザー ドキュメント一覧 (英語)
•   ActivePDF Toolkit 2011 API リファレンス (一部日本語)   (Toolkit 2016 でも Toolkit 2011 のほとんどのメソッドやプロパティを使用することができます。)

日本語フォントの使用について

追加する文字列に日本語フォントを指定する場合は、フォント名ではなく、フルパスでファイル名 (例 "C:\Windows\Fonts\msgothic.ttc" や "C:\Windows\Fonts\msmincho.ttc") を指定してください。

 Set objTK = CreateObject("APToolkit.Object")
              
 ' 生成する PDF を指定します。
 r = objTK.OpenOutputFile(App.Path & "\new.pdf")
 
 ' ActivePDF に含まれるフォントを使用する場合
 objTK.SetFont "C:\Windows\Fonts\msgothic.ttc", 15
 objTK.PrintText 100, 700, "日本語フォントのテスト"

 objTK.CloseOutputFile
              
 Set objTK = Nothing
        

ActivePDF Toolkit 2011 R4 より前のバージョンの ActivePDF Toolkit で日本語フォントを使用する場合、日本語フォントで使用されている TTC フォントを TTF フォントへ分割する必要があります。次のステップをご確認ください。

1. フォント分割ツールを使用して TTC ファイルを TTF ファイルに分割します。
2. 下記のサンプル コードをお試しください。

 Set objTK = CreateObject("APToolkit.Object")
              
 ' 生成する PDF を指定します。
 r = objTK.OpenOutputFile(App.Path & "\new.pdf")
 
 ' ActivePDF に含まれるフォントを使用する場合
 objTK.SetFont "HeiseiMin-W3-Acro|encoding=UniJIS-UCS2-H", 15
 objTK.PrintText 100, 700, "日本語フォントのテスト : ネイティブ フォント"
              
 ' Windows に含まれるフォントを使用する場合
 ' フォント分割ツールを使用して TTC ファイルを TTF ファイルに分割する必要があります。
 objTK.SetFont "C:\Windows\Fonts\msuigothic.ttf", 15
 objTK.PrintText 100, 650, "日本語フォントのテスト : Windows フォント"
              
 objTK.CloseOutputFile
              
 Set objTK = Nothing
        

.NET 環境に関する情報

.NET 環境で適切にオブジェクトのインスタンスを作成するには .NET スクリプト環境で APToolkitNET.dll を参照する必要があります。APToolkitNET.dll への参照が不正または未設定の場合、結果スクリプトは missing type または name space error を引き起こします。

  APToolkitNET.dll への参照を追加する方法

1. Visual Studio .NET の [ソリューション エクスプローラ] ウィンドウの [参照設定] を右クリックし、[参照の追加] を選択します。
2. [参照の追加] ダイアログの [参照] ボタンをクリックします。
3. [コンポーネントの選択] 画面で APToolkitNET.dll を選択し、[開く] ボタンをクリックします。

使用する .NET のバージョンにより、参照する APToolkitNET.dll が異なりますのでご注意ください。

• .NET 1.1 を使用する場合: X:\Program Files\activePDF\DotNetComponent\1.1\APToolkitNET.dll
• .NET 2.0 を使用する場合: X:\Program Files\activePDF\DotNetComponent\2.0\APToolkitNET.dll

Toolkit 10.1.0 から APToolkitNET.dll のインストール場所が変更となっています。詳細は、Toolkit 10.1.0 の リリースノートをご参照ください。

PDF の座標について

Toolkit の処理に関するよくあるご質問

• フィールドにデータを投入した PDF を StitchPDF メソッドでステッチすると、フィールドのデータが消えてしまいます。
• EncryptPDF メソッドで AES 256 bit に暗号化したファイルを Adobe Reader 8 や 9 で開けません。
• AddField メソッドを呼び出した後、SetFormFieldData を呼び、フィールドを単層化する為に -997 のフラグを設定しても、フィールドを単層化できません。
• OpenInputFile と CopyForm メソッドで、フォントがリンクしている PDF を呼び出すと、プロセスが 1GB 以上のメモリを使用してしまいます。
• PrintMultilineText メソッドで両端揃えに設定しても、出力されるテキストが左寄せになっています。
• パスワードを設定しないと、暗号化できません。
• フォームフィールドのフォントを Arial に設定すると、日本語が適切に表示されません。
• SetFormFieldData メソッドを使用後、フィールドの計算が適切に動作していません。
• バーコードの BorderStyle を使用すると、設定が無視されます。
• フォームフィールドからフォーカスが外れると、フォームフィールド内のテキストの表示が変わってしまいます。
• ディスクから読み込むフォント用に、明示的にエンコードを設定すると、適切に PDF を出力できません
• SetOutputRotation(90) を呼んでも、出力したページの向きが変わりません。
• DisableFontCache プロパティを有効にすると、出力したファイル内の文字が文字化けします。
• SetFont メソッドの defaultwidth パラメターを設定しても、出力するスタンプに変化がありません。
• 2 つのファイルを結合すると、テキスト フィールドが消えてしまいます。
• FieldInfo プロパティの FontName に Arial を指定しても、Arial MT が設定されます。

フィールドにデータを投入した PDF を StitchPDF メソッドでステッチすると、フィールドのデータが消えてしまいます。

ステッチの処理では、フォーム フィールドの情報は移行できません。データを含むフィールドがある PDF をステッチする場合は、StitchPDF を呼び出す前に、 SetFormFieldData を使用した場合は、フラグに -998 を使用してフォーム フィールドを単層化し、 FlattenRemainingFormFields で、残りのフォーム フィールドも単層化してください。

ノート: 単層化していないフィールドは、ステッチ処理時に削除されてしまう為、出力ファイルでは表示されません。

EncryptPDF メソッドで AES 256 bit に暗号化したファイルを Adobe Reader 8 や 9 で開けません。

Acrobat Reader のバージョン 8 および 9 は、AES 256bit の暗号化に対応していません。Acrobat Reader のバージョン 10 以降で開くか、暗号化レベルを下げてください。

AddField メソッドを呼び出した後、SetFormFieldData を呼び、フィールドを単層化する為に -997 のフラグを設定しても、フィールドを単層化できません。

AddField メソッドを呼び出した後、PDF を閉じて、再度開きます。その後に、フィールドを単層化する為に、SetFormFieldData でフラグに -997 を設定してください。

OpenInputFile と CopyForm メソッドで、フォントがリンクしている PDF を呼び出すと、プロセスが 1GB 以上のメモリを使用してしまいます。

Before calling CopyForm, call the DisableFontCache property and set it to true.

PrintMultilineText メソッドで両端揃えに設定しても、出力されるテキストが左寄せになっています。

現在、テキストの配置の調整ができるのは、以下のエンコードを使用するフォントだけになっています。

• WinAnsiEncoding
• PDFDocEncoding
• MacRomanEncoding

ダブルバイト フォントを使う日本語や、上記のエンコードを使用しないフォントの場合は、エンコード パラメターを設定することで配置の調整が可能です。

例

aPDF.PrintMultilineText "Calibri|encoding=WinAnsiEncoding",
16, 300, 600, 100, 500, stringText, 3, 0

ノート: 現在、両端揃えを設定できるのはプロポーショナル フォントのみです。プロポーショナルフォント以外のフォントは、左寄せか右寄せになります。

パスワードを設定しないと、暗号化できません。

ファイルを暗号化する場合は、パスワードを設定してください。SetInputPasswords または DecryptFile メソッドを使用する際、入力ファイルにパスワードが設定されていない場合、Toolkit は、空白のパスワードとして判断します。

フォームフィールドのフォントを Arial に設定すると、日本語が適切に表示されません。

AddField でフォームを設定する際に、FontName には Arial Unicode MS を指定してください。

ノート: Arial Unicode MS は、日本語をビルトインサポートしています。

SetFormFieldData メソッドを使用後、フィールドの計算が適切に動作していません。

Acrobat Reader は、PDF を開いた際に自動的にフィールド レベルの JavaScript の計算を実行しません。Acrobat Reader の [環境設定] - [フォーム] にある [フィールド値の自動計算] を選択している場合、ユーザーがフィールドに値を入力した際に計算が実行されますが、PDF を開いたときには計算は実行されません。PDF を開いたときに計算を実行するには、ドキュメント レベルの JavaScript を追加します。

1. Adobe Acrobat で、[表示] - [ツール] - [JavaScript] を選択し、[文書レベル JavaScript を編集] を選択します。
2. スクリプトの名前 (例: Init) を入力します。
3. [追加] ボタンをクリックします。
4. ウインドウ内の内容をすべて削除します。
5. this.calculateNow(); を入力します。
6. [OK] ボタンをクリックします。
7. PDF を保存します。

これで PDF を開いたときにフォームの自動計算が行われるようになります。

バーコードの BorderStyle プロパティを使用しても、設定が無視されます。

BorderStyle プロパティは廃止となり、使用することができません。現在、同等のプロパティもありません。

フォームフィールドからフォーカスが外れると、フォームフィールド内のテキストの表示が変わってしまいます。

TrueType フォントを使用し、編集予定のあるフォーム フィールドには、使用するキャラクター セットを含んだエンコードを設定する必要があります。エンコードのパラメターを含んだ FontName のシンタックスの例は以下の通りです。

FIO.FontName "Helvetica|encoding=WinAnsiEncoding", 12

ノート: エンコードを設定しない場合、Toolkit はデフォルトの Identity-H エンコードを使用します。この場合、フォームの編集時に文字が抜けていたり、文字化けすることがあります。

ディスクから読み込むフォント用に、明示的にエンコードを設定すると、適切に PDF を出力できません。

Toolkit では、ビルトイン フォントを使用しているビルトイン エンコード (例 Adobe-GB1-USC2) でのフォントの設定に対応しています。ファイル内でフォントが既に指定されている場合にのみ、ディスクから読み込むフォントのエンコードをサポートします。

SetOutputRotation(90) を設定しても、出力したページの向きが変わりません。

入力ファイルが既に 90 度に回転していると、 SetOutputRotation(90) を設定しても、出力ファイルに変化が表れません。更に 90 度回転させる場合は、 SetOutputRotation(180) を設定します。

PDF 作成ソフト (プリンター ドライバーやスキャナーを含む) によっては、PDF のページの回転の設定をページの向きに設定し、テキストの方向を合わせています。PDF が縦長に見えても、内部のページの回転度数は 90 度のこともあります。

Toolkit では、GetInputPageRotation と GetBoundingBox を組み合わせて呼び出すことで、ページの回転度数を取得し、回転度数に合わせて調整することができます。これらのメソッドの使用例は、 こちらのページをご参照ください。

DisableFontCache プロパティを有効にすると、出力したファイル内の文字が文字化けします。

ステッチする際に、Toolkit はフォント キャッシュを使用します。StitchPDF を使用する前に、DisableFontCache を無効にし、フォント キャッシュを有効にしてください。

SetFont メソッドの defaultwidth パラメターを設定しても、出力するスタンプに変化がありません。

DefaultWidth パラメターは、シングルバイトのプロポーショナルフォントには適用されません。このオプションは、固定幅の中国語、日本語、韓国語フォントが使用するダブルバイト エンコードに適用されます。ダブルバイト フォントの幅の基準が無い場合、DefaultWidth を基準として使用することができます。

2 つのファイルを結合すると、テキスト フィールドが消えてしまいます。

MergeFile を使用した際にフォームフィールドを残すには、OpenOutputFile を呼び出した後に ReadOnlyOnMerge を呼び出してください。または、MergeFile を使用せずに、CopyForm を使用してください。

FieldInfo プロパティの FontName に Arial を指定しても、Arial MT が設定されます。

PDF の仕様に沿って、Toolkit は、BaseFont の値となる PostScript 名を以下のいずれかで判断します。

• TrueType フォント プログラムの名前のテーブルに PostScript 名がある場合、その名前が使用されます。
• 名前のテーブルに名前が無い場合、PostScript 名はホスト OS で使用されている名前が使用されます。Windows システムでは、LOGFONT 構造体の IfFaceName フィールドの名前が使用されます。Mac OS では、FOND リソースの名前となります。

この結果として、Toolkit はディスクから Arial フォントを読み込む際に、Postscript 名の Arial MT を選択します。この動作は FontFaceName を設定することで、フォント名を変更することもできます。

"Arial|fontfacename=Arial"

この場合、Arial MT の代わりに Arial が選択されます。