開発者向けPDFライブラリ - Toolbox Add-on
.NETによるサンプルの開始手順
ここではToolbox Add-onサンプルプロジェクトを使用する手順を説明し、.NET言語を使用して(Pdftools SDK) Toolbox Add-onをアプリケーションに統合する方法について説明しています。
試用ライセンスと正規ライセンス
Toolbox Add-onは評価試用と正規使用のいずれの場合にもライセンスキーが必要です。

TIP:
Pdftools SDKの正規ライセンスキーはToolbox Add-onで正規ライセンスとして使用できます。
前提条件
Pdftools SDKをPythonで使用するには Python 3.7 以上が必要です。
サンプル プロジェクト(Python)のコンパイルと実行
Pythonの「PDFにテキストを追加するサンプル」を使って手順を説明します。
開発環境がVisual Studioまたはコマンドラインいずれかの場合を選択してください。
Visual Studio
コマンドライン

ここではVisual Studio 2022を使った説明です。
- サンプルプロジェクトをダウンロードし、適切なフォルダーに解凍します
- ライセンスキーを用意します
- サンプルフォルダー内の
ToolboxImageExtraction.csproj
をVisual Studioで開きます
- ファイル
Program.c
から以下の部分を探し、以下の"insert-license-key-here"
を試用版(または正規)ライセンスキーに置き換えます。
Sdk.Initialize("insert-license-key-here", null);
ライセンスキーには小なり記号「<
」と大なり記号「>
」を含めて使用してください。
- Visual Studioのメインメニューから「ビルド」->「ソリューションのビルド」を選択し、コンパイルします
- サンプルプロジェクト内でターミナルを開きます
- PDFファイル
ImageCollection.pdf
からすべての画像と画像マスクを出力フォルダー/tmp/images
に抽出するには、以下を実行します。
ToolboxImageExtraction ImageCollection.pdf /tmp/images
- サンプルプロジェクトをダウンロードし、適切なフォルダーに解凍します
- ライセンスキーを用意します
- コマンドラインで解凍したフォルダーの先頭(root)に移動します
Program.cs
ファイルで、文字列"insert-license-key-here"
をライセンス キーに置き換えます。
Sdk.Initialize("insert-license-key-here", null);
ライセンスキーには小なり記号「<
」と大なり記号「>
」を含めて使用してください。
- コマンド ラインで解凍したサンプル・プロジェクトのrootディレクトリに移動します。
- PDFファイル
ImageCollection.pdf
からすべての画像と画像マスクを出力ディレクトリ/tmp/images
に抽出するには、以下のコマンドを実行します。
dotnet run --framework net6.0 --project ToolboxImageExtraction.csproj ImageCollection.pdf /tmp/images

TIP:
このチュートリアルで説明した手順は、他のコードサンプルにも適用できます。
Pdftools SDKを自身のアプリケーションに統合
次の手順に従ってPdftools SDKを自身のアプリケーションに統合してから初期化して使用を開始します。
Pdftools Add-onを自身のプロジェクトに追加する
Visual Studioコマンドライン

ここではVisual Studio 2022を使った説明です。
- 自身のソリューションをVisual Studioで開きます
- Visual Studioのメインメニューから「ツール」->「NuGetパッケージマネージャ」->「ソリューションのNuGet管理...」を選択します
- 管理画面の「参照」タブに切り替えてから
Pdftools.Toolbox
を検索します
- 検索された中から
Pdftools.Toolbox 作成者 pdf-tools-ag
を選択し、自身のプロジェクトにインストールします
- OKをクリックして変更を有効して、License Agreement(使用許諾契約)にAccept(同意)するとPdftools SDKが組込まれます
- 自身のプロジェクトディレクトリで以下のコマンドを実行します。
dotnet add package PdfTools.Toolbox
- (オプション)Pdftools SDKのバージョンを指定する場合は上記に替えて以下を実行します
dotnet add package PdfTools --version VERSION_NUMBER
VERSION_NUMBER
は必要なバージョン番号に替えます
Toolbox Add-onを正規ライセンスキーで初期化
Toolbox Add-onを試用版ライセンスキー(無償)で試用すると結果に透かしが追加されます。
透かしなしの結果を得るためには正規ライセンスキーが必要です。ライセンスキーを使った初期化の手順は以下の通りです。
正規ライセンスキーは見積もりとともにご要望ください。
- ライセンスキーはASCII文字列で<XXXXX...XXXXX>形式です。小なり(
<
)と大なり(>
)文字を含みます。
- Toolbox Add-onを利用するにあったって、最初に以下のようにメソッド
Sdk.Initialize
をコールしてください。
Sdk.Initialize("insert-license-key-here");
上記コードの「insert-license-key-here
」の部分を小なり(<
)と大なり(>
)文字を含んだライセンスキー文字列に置き換えてください。
お問い合わせ、ご質問、技術サポート
質問のページからお送りいただくようお願いします。
または、メールでsupport@trustss.co.jpあてにお送りください。
ご購入前の技術的質問も無償で対応します。サポート受付ページからお願いします。