トラスト・ソフトウェア・システム
トラスト・ソフトウェア・システム

PDF Prep Tool Suite リンク追加C#サンプル

「PDF Prep Tool Suite」ソフトは、PDF文書を作成、編集、分割、統合するためのAPI(ライブラリ)です。

PDF文書にテキスト・コンテント、画像、ベクタ・グラフィックスを追加します。 さらに、インターラクティブな要素(ハイパー・リンク、フォーム・フィールド、ブックマークなど)を追加し処理します。

PDF文書は、新たに生成することができます。プロパティ(位置、フォント、サイズ、色など)は自由に選択できます。 作成されたPDF文書には、暗号化やWebの表示用に最適化が施されます。

機能概要はこちらです。
無償評価版(リンク先は英語)はこちらです。 ダウンロード手順
他のC#サンプルC++サンプルを公開しています。
PDF Prep Tool Suite ソフト 購入(価格)

無償評価版のダウンロードとインストール

 ライブラリ(評価版API)は無償でダウンロード(試用)できますので、PDF Prep Tool Suiteダウンロード手順を参照してダウンロードください。
 ファイルをダウンロードしてから、インストールもしくは適当なフォルダーに解凍します。以下のようなフォルダーができあがりますので、適宜ご利用ください。
binライブラリやライセンスマネージャーなど
doc使用説明書やjavadocなど
includeC/C++用のヘッダー(.h)ファイル
jarPrepTool.jar、I2PA.jar(Javaのラッパー)
libC/C++用のlibファイル
ご注意ください:サンプル(英語版)はPDF Tools AG社のページからダウンロードできますが、それを動作させるためにはコードの変更が必要な場合があります。
以下のサンプルは、正しい動作を確認しています。ソースコードはこちらからダウンロードできます。

無償評価版と共にダウンロードしたライセンスキーをbin/LicenseManager.exeを使って登録してください。 ライセンスキーの登録方法はこちらです。

COMインターフェースとして、bin/pdprep32.dll、bin/Img2PdfAPI.dllをregsvr32.exeを使って登録してください。なお、64ビット版Windowsの場合は、WOW64/regsvr32.exeを使って登録してください。
文字化けする場合は、bin/pdcjk.dllをサンプル実行イメージと同じフォルダーにコピーしてください。

参照設定

C#プロジェクトでは、以下のように.NET用DLLの参照を設定します。なお、サンプルは、基本的にコンソールアプリケーションです。
  1. C#プロジェクトを新規に作成します。
  2. PDF Prep Tool SuiteライブラリのNETラッパを参照する設定をします。
  3. Visual Studio C#のメインメニューで、「プロジェクト(P)」→「参照の追加(R)...」を選択します。
    以下のようなダイアログが表示されますので、解凍して作成されたフォルダーの「bin」に格納されている.NET用のDLLおよびpdprep32.dllを指定します。
    PDF Prep Tool参照設定

リンクを追加するC#サンプルと解説

 Webリンクと文書内リンクを追加するサンプルです。
using System;
using PREPTOOLLib;

namespace ann
{
    class Ann
    {
        static void Main(string[] args)
        {
            //インスタンス生成
            PDoc doc = new PDoc();

            //結果のPDF文書を生成
            if (!doc.New("output.pdf", 595, 842))
            {
                Console.WriteLine("'output.pdf'を生成できませんでした。");
                >Environment.Exit(1);
            }
            content header = doc.Header();

            //入力のPDF文書
            if (!doc.InputOpen("input.pdf"))
            {
                Console.WriteLine("'input.pdf'を開けませんでした。");
                Environment.Exit(2);
            }
            IDoc inp = doc.Input();

            //フォントを指定
            if (!header.SetFont("Courier", 12))
            {
                Console.WriteLine("フォントを設定できませんでした。");
                Environment.Exit(3);
            }

            // Webリンクを追加
            // ------------------
            // リンク先 http://www.pdf-tools.trustss.co.jp/
            //
            header.SetTm(1, 0, 0, 1, 22, 22);
            header.PrintText("http://www.pdf-tools.trustss.co.jp/", 21, 24);
            doc.AddWebLink(1, 20, 20, 274, 34, "http://www.pdf-tools.trustss.co.jp/", 6);

            // 文書内リンクの追加
            // ------------------
            // リンク先 第1ページの先頭
            //
            header.SetTm(1, 0, 0, 1, 22, 62);
            header.PrintText("Go to Top of 1st page", 22, 62);
            doc.AddGoToLink(1, 20, 60, 180, 16, 1, 0, 792, 2, 0);   //移動先

            // 最初のページをコピーする。このときテキストを含んだヘッダーがマージされる
            doc.InputCopyPages(1, 1);

            //ヘッダをクリア(テキストを削除)する
            doc.HeaderClear();

            //残りのページをコピーして文書を閉じる
            doc.InputCopyPages(2, -1);
            doc.Close();
        }
    }
}
このサンプルでは、以下の手順でPDFを作成します。
  1. PDFを操作するインスタンスを生成
  2. PDFインスタンスで結果のPDFファイル作成
  3. PDFインスタンスの最上位レイヤー(Header)を取得
    このレイヤーは、PDFインスタンスにページを生成(またはコピー)するごとにマージされます。そのため、このレイヤーはすべてのページで共通になります。
    マージの必要が無い場合は、レイヤーの内容をクリア(削除)しなければなりません。
  4. PDFインスタンスで入力PDFを開く
  5. 入力PDFを取り扱うインスタンスを取得
    入力PDFのページを指定する場合などでこのインスタンスを使います。
  6. フォントを指定する
    最上位レイヤーに追加する文字列のフォントを指定します。
    Acrobatにビルトインされたフォントの場合は、PDF Prep Tool Suiteがサポートしていますので、フォント名を指定するだけで利用できます。 しかし、それ以外のフォントや日本語フォントを利用する場合は、日本語フォントのテンプレートのようなPDFファイルが必要な場合があります。
  7. WebリンクをHeaderに追加
  8. 文書内リンクをHeaderに追加
  9. 最初のページを追加したリンクと共にコピー
  10. Headerをクリア(削除)
    2ページ以降には、リンクを追加しないのでHeaderをクリアします。
  11. 2ページ以降をすべてコピー
  12. PDFを閉じる
PDoc doc = new PDoc() インスタンス生成
doc.New( ) 結果のPDFインスタンスを生成
引数に以下の値を設定します。
第一引数作成するPDF文書のファイル(パス)名
第二引数作成するPDF文書のページ幅(ポイント単位)
第三引数作成するPDF文書のページ高さ(ポイント単位)
content header = doc.Header() Headerレイヤーのインスタンスを取得
Headerは、PDFのレイヤーでページの最上層に位置します。すべてのページで共通のレイヤーです。 透かし(ウォーターマーク)を追加する場合は、このレイヤーを利用します。
doc.InputOpen( ) 入力PDFを開く
引数に入力PDF文書ファイル(パス)名を設定します。
IDoc inp = doc.Input() 入力PDFのインスタンス取得
header.SetFont( ) フォントを指定
ここでは、Headerレイヤーにテキスト文字を追加(PrintText)するためにフォントを指定します。header.PrintTextをコールする前にフォントを指定しなければなりません。
引数に以下の値を設定します。
第一引数フォントの名前
第二引数フォントのサイズ
Acrobatにビルトインされたフォント(Helvetica、Helvetica-Bold、Helvetica-Oblique、Times-Roman、Times-Italic、Times-Bold、Courier、Courier-Oblique、Courier-Bold、Symbol、ZapfDingbats)は、この例のように利用できます。 これ以外のフォントや日本語フォントを利用する場合は、日本語フォントのテンプレートを参照してください。
header.SetTm( ) テキスト配置の変換行列を指定
引数に以下の値を設定します。
第一引数注1参照
第二引数注1参照
第三引数注1参照
第四引数注1参照
第五引数テキストの書き出しX座標
第六引数テキストの書き出しY座標
注1)第一引数から第四引数の値でテキストの回転を指定します。[1 0 0 1]を指定すると、テキストを左から右へ横方向に書き出します。文字列を襷がけのように書き出す方法を参照してください。
header.PrintText( ) 書き出す文字列を指定
引数に以下の値を設定します。
第一引数書き出す文字列
第二引数テキストの書き出しX座標
第三引数テキストの書き出しY座標
doc.AddWebLink( ) Webリンクを追加
引数に以下の値を設定します。
第一引数Webリンクを追加するページの番号
第二引数Webリンクの領域 Left-座標
第三引数Webリンクの領域 Bottom-座標
第四引数Webリンクの領域 Right-座標
第五引数Webリンクの領域 Top-座標
第六引数リンク先URL
第七引数領域を示す枠線のスタイル
以下の値を指定できます。
設定値スタイル
-1非表示
0黒色実線
1赤色点線
2赤色実線
3緑色鎖線
4緑色実線
5青色鎖線
6青色実線
doc.AddGoToLink( ) 内部リンク領域との移動指定
引数に以下の値を設定します。
第一引数内部リンクのページ番号
第二引数内部リンクの領域 Left-座標
第三引数内部リンクの領域 Bottom-座標
第四引数内部リンクの領域 Right-座標
第五引数内部リンクの領域 Top-座標
第六引数移動先のページ番号
第七引数移動先 X-座標
第八引数移動先 Y-座標
第九引数内部リンク領域を示す枠線のスタイル
第十引数移動先のズーム値
doc.InputCopyPages( ) 入力PDFのページを出力にコピー
このこーピーの際に、Headerレイヤーがマージされます。引数に以下の値を設定します。
第一引数コピーを開始するページ番号
第二引数コピーを終了するページ番号
-1を指定すると最終のページまでがコピーされます。
doc.HeaderClear() Headerレイヤーをクリアー
これ以降では、ページコピーの際にHeaderレイヤーがマージされてもページは変更されません。
doc.InputCopyAll() 入力PDFのすべてのページを出力PDFにコピー
doc.Close() PDFを閉じる

サンプルコード

 C# PDF Prep Tool Suite サンプル (MS Visual Studio 2008 Project) PtsCspSamples.zip

ご質問、お問い合わせ

 メールで support@TrustSS.co.jp 宛てにお送りください。
または、質問のページからお送りいただくようお願いします。ご要望も承っております。(匿名で送れます。)

(記載の会社名および製品名は、各社の登録商標および商標です。)
PDF製品 C#サンプル
PDF Security
PDF Validator
PDF to PDF/A Converter
PDF to Image Converter
PDF Imager-LP
Image to PDF Converter
PDF Printer
PDF Viewer
PDF Viewer-L
PDF Prep Tool Suite
PDF Optimization
PDF Command Line Suite
PDF Extract
PDF Easy Parse
株)トラスト・ソフトウェア・システム
暗号化・電子署名・タイムスタンプ ライブラリ作成します。
お問い合わせください。