Add TOC
Documentize PDF Manager for .NET は、目次 (TOC) を動的に生成することで、PDF文書の整理とナビゲーションを向上させるために設計された強力なプラグインです。このプラグインは、PDFにTOCを追加するプロセスを簡素化し、文書をよりナビゲートしやすく、管理しやすくします。
PDFのTOCを生成する方法
PDFファイルに目次を作成するには、以下の手順に従います。
- TOC生成設定を構成するために
TocOptions
のインスタンスを作成します。 Title
プロパティを使用してタイトルを設定します。Headings.Add
メソッドを使用してTOCの見出しをデザインします。AddInput
メソッドを使用して入力PDFファイルを追加します。AddOutput
メソッドを使用してTOCを含む出力PDFファイルを指定します。AddTableOfContents
メソッドを呼び出してTOCを生成します。
1// TocOptionsオブジェクトを作成して指示を設定
2var options = new TocOptions();
3// タイトルを設定
4options.Title = "My Table of Contents";
5// 見出しをデザイン
6options.Headings.Add(new TocHeading("Introduction", 2));
7options.Headings.Add(new TocHeading("Chapter I", 3));
8options.Headings.Add(new TocHeading("Chapter II", 4));
9options.Headings.Add(new TocHeading("Chapter III", 5));
10// 入力ファイルパスを追加
11options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
12// 出力ファイルパスを設定
13options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
14// プロセスを実行
15PdfManager.AddTableOfContents(options);
PDFのTOCにブックマークを生成する
ブックマーク生成には ‘GenerateBookmarks’ プロパティを使用できます。
1// TocOptionsオブジェクトを作成して指示を設定
2var options = new TocOptions();
3// タイトルを設定
4options.Title = "My Table of Contents";
5// ブックマークにリンクを生成
6options.GenerateBookmarks = true;
7// 見出しをデザイン
8options.Headings.Add(new TocHeading("Introduction", 2, false, 1));
9options.Headings.Add(new TocHeading("Chapter I", 3, true, 1));
10options.Headings.Add(new TocHeading("Chapter II", 4, true, 1));
11options.Headings.Add(new TocHeading("Example A", 4, true, 2));
12options.Headings.Add(new TocHeading("Example B", 4, true, 2));
13options.Headings.Add(new TocHeading("Example C", 4, true, 2));
14options.Headings.Add(new TocHeading("Example D", 4, true, 2));
15options.Headings.Add(new TocHeading("Chapter III", 5, true, 1));
16// 入力ファイルパスを追加
17options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
18// 出力ファイルパスを設定
19options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
20// プロセスを実行
21PdfManager.AddTableOfContents(options);
結果をストリームとして取得する方法
1// TocOptionsオブジェクトを作成して指示を設定
2var options = new TocOptions();
3// タイトルを設定
4options.Title = "My Table of Contents";
5// 見出しをデザイン
6options.Headings.Add(new TocHeading("Introduction", 2, false, 1));
7// 入力ファイルパスを追加
8options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
9// 出力ストリームを設定
10var outputStream = new MemoryStream();
11options.AddOutput(new StreamDataSource(outputStream));
12options.CloseOutputStreams = false;
13// プロセスを実行
14PdfManager.AddTableOfContents(options);
TOCの見出しをカスタマイズする
TocHeading
クラスを修正することで、目次の見出しをカスタマイズできます。例えば、‘GenerateNumbering’ を使用したり、手動で行うことができます。
ページ上のリンクに使用される ‘PageNumber’ プロパティや、レベルプロパティも使用できます。
1var heading = new TocHeading();
2heading.Text = "Intro";
3heading.PageNumber = 5;
4heading.GenerateNumbering = true;
5heading.Level = 2;
6
7var tocOptions = new TocOptions();
8options.Headings.Add(heading);
9// 入力ファイルと出力ファイルを追加
10tocOptions.AddInput(new FileDataSource(@"C:\Samples\input.pdf"));
11tocOptions.AddOutput(new FileDataSource(@"C:\Samples\output_with_toc.pdf"));
12
13// カスタマイズされたオプションでTOCを生成
14PdfManager.AddTableOfContents(tocOptions);
主な機能:
- 動的TOC生成: 見出しやブックマークに基づいて自動的に生成されたエントリを使用して、任意のPDFファイルのTOCを作成します。
- カスタマイズ: スタイル、フォーマット、深さのレベルを含むTOCの外観と構造を制御します。
- 効率的なワークフロー: 特に大規模または複雑な文書のTOCを手動で作成する時間を最小限に抑えます。