ブックマークを使用すると、大きなドキュメント内のナビゲーションが容易になります。読者は、ドキュメント全体をスクロールする代わりに、さまざまなページやセクション間を簡単に移動できます。Aspose.PDF Cloud API は、多くの PDF 操作機能を提供します。ブックマークの操作は、API でよく使用される機能の 1 つです。このブログでは、次の使用例について学習します。
- PDF文書にブックマークを追加する
- PDF文書内のブックマークを削除する
- PDF ドキュメントのブックマークを更新する
Aspose.PDF Cloud API は、C#、Java、Python、Go、Ruby、PHP など、多くのプログラミング言語をサポートしています。それぞれの SDK が便利に利用できます。SDK はリクエストと応答に関連する細かい部分を処理するため、SDK のいずれかをアプリケーションに簡単に統合できます。これにより、アプリケーションに含めたい主要な機能に集中できます。.NET アプリケーションのブックマーク関連機能に移りましょう。
PDF文書にブックマークを追加する
法的書類などの文書を提出する際には、ブックマークの追加が必須条件となる場合があります。このようなシナリオでは、アプリケーションですべてのニーズに対応できます。ブックマークの属性またはプロパティを指定して、PDF ファイルにブックマークを挿入する要求を送信するだけです。以下の C# コードは、この機能の使用例です。
// https://dashboard.aspose.cloud/ から AppKey と AppSID を取得します。
// NuGet パッケージ Aspose.Pdf-Cloud をインストールする
// 完全な例とデータファイルについては、https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-dotnet をご覧ください。
PdfApi pdfApi = new PdfApi(AppKey, AppSid);
const string name = "PdfWithBookmarks.pdf";
string bookmarkPath = "2";
var bookmark = new Bookmark();
bookmark.Action = "GoTo";
bookmark.Bold = true;
bookmark.Italic = false;
bookmark.Title = "New Bookmark XYZ";
bookmark.PageDisplay = "XYZ";
bookmark.PageDisplayBottom = 10;
bookmark.PageDisplayLeft = 10;
bookmark.PageDisplayRight = 10;
bookmark.PageDisplayTop = 10;
bookmark.PageDisplayZoom = 2;
bookmark.PageNumber = 2;
bookmark.Color = new Color(255, 255, 0, 0);
var bookmarks = new List<Bookmark>();
bookmarks.Add(bookmark);
var response = pdfApi.PostBookmark(name, bookmarkPath, bookmarks, folder: TempFolder);
ここでは、Bookmark クラスのほぼすべての属性は一目瞭然です。ただし、bookmarkPath パラメータはツリー内の親ブックマークを指します。ルートにブックマークを追加する場合は、パスとして空の文字列を指定する必要があります。以下は、上記のコード スニペットによって追加されたブックマークを含む出力 PDF ドキュメントのスクリーンショットです。
PDF ドキュメントのブックマークを削除する
ここで注意すべき重要な点は、親ブックマークを削除すると、その子ブックマークもすべて削除されるということです。ただし、ブックマークを削除しても、テキストやドキュメントの一部は削除されません。C# 言語の例でこれを学習しましょう。
// https://dashboard.aspose.cloud/ から AppKey と AppSID を取得します。
// NuGet パッケージ Aspose.Pdf-Cloud をインストールする
// 完全な例とデータファイルについては、https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-dotnet をご覧ください。
PdfApi pdfApi = new PdfApi(AppKey, AppSid);
const string name = "PdfWithBookmarks.pdf";
string bookmarkPath = "1/1";
var response = pdfApi.DeleteBookmark(name, bookmarkPath, folder: TempFolder);
API を呼び出す前に、上で説明したように bookmarkPath プロパティを指定するだけでよいことがわかります。
PDF ドキュメントのブックマークを更新する
ブックマークの名前を変更したり、更新先や外観を変更したりして、PDF ドキュメント内のブックマークを更新する必要がある場合があります。API はこれらの機能もサポートできるほど高度です。以下のコード スニペットを使用してブックマークを更新できます。
// https://dashboard.aspose.cloud/ から AppKey と AppSID を取得します。
// NuGet パッケージ Aspose.Pdf-Cloud をインストールする
// 完全な例とデータファイルについては、https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-dotnet をご覧ください。
PdfApi pdfApi = new PdfApi(AppKey, AppSid);
const string name = "PdfWithBookmarks.pdf";
string bookmarkPath = "1/1";
var bookmark = new Bookmark();
bookmark.Action = "GoTo";
bookmark.Bold = true;
bookmark.Italic = false;
bookmark.Title = "Updated Bookmark XYZ";
bookmark.PageDisplay = "XYZ";
bookmark.PageDisplayBottom = 10;
bookmark.PageDisplayLeft = 10;
bookmark.PageDisplayRight = 10;
bookmark.PageDisplayTop = 10;
bookmark.PageDisplayZoom = 2;
bookmark.PageNumber = 2;
bookmark.Color = new Color(255, 255, 0, 0);
var response = PdfApi.PutBookmark(name, bookmarkPath, bookmark, folder: TempFolder);
API が提供するその他の機能に興味がありますか? API ドキュメント でいくつかの可能性を調べることができます。API の完全な機能をテストしたい場合は、サインアップ して無料で API をご利用ください。ご質問がある場合は、無料サポート フォーラム からお気軽にお問い合わせください。
関連記事
詳細については、次のリンクにアクセスすることをお勧めします。