構造要素ツリーを作成する

導入

PDF を扱う場合、特にアクセシビリティと構造化されたコンテンツの確保を目指す場合、構造要素ツリーを作成することが重要です。このツリーはドキュメントの骨組みと考えてください。このツリーは、コンテンツの整理と管理に役立つレイアウトを提供します。Aspose.PDF for .NET を初めて使用する場合でも心配はいりません。この記事では、プロセスをステップごとに説明します。

前提条件

コードの詳細に入る前に、必要なものがすべて揃っていることを確認してください。

Aspose.PDF for .NET: このライブラリがインストールされていることを確認してください。ここからダウンロードできます:Aspose.PDF for .NET をダウンロード.
.NET 環境: 動作する .NET 開発環境 (Visual Studio など) が必要です。
基本的な C# の知識: C# の基礎を理解することで、概念を素早く理解できるようになります。

まだご覧になっていない方は、ドキュメント詳しい情報についてはこちらをご覧ください。

パッケージのインポート

コーディングを始める前に、.NET アプリケーションに必要な名前空間をインポートする必要があります。その方法は次のとおりです。

using Aspose.Pdf.LogicalStructure;
using Aspose.Pdf.Tagged;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

これにより、プログラムに、タグ付き PDF 機能を含む Aspose の PDF 機能を使用するように指示します。それでは、袖をまくってコードに取り掛かりましょう。

ステップ1: ドキュメントパスを定義する

まず最初に、PDF ドキュメントを保存する場所を決める必要があります。本を置く棚を選ぶようなものです。

//ドキュメント ディレクトリへのパス。
string dataDir = "YOUR DOCUMENT DIRECTORY";

必ず交換してください"YOUR DOCUMENT DIRECTORY"実際のファイルパスを入力します。最終的な PDF はここに保存されます。

ステップ2: PDFドキュメントを作成する

さて、ドキュメント自体を作成します。これは、本の最初のページを作成するようなものだと考えてください。

Document document = new Document();

この行は、構築の基となる新しい PDF ドキュメントを作成します。

ステップ3: タグ付きコンテンツを初期化する

この部分から魔法が始まります。ドキュメントのタグ付けされたコンテンツにアクセスする必要があります。

// TaggedPdfで作業用のコンテンツを取得する
ITaggedContent taggedContent = document.TaggedContent;

こうすることで、傑作を描くための空のキャンバスを準備するのと同じように、構造化されたデータを保持するドキュメントを準備することになります。

ステップ4: タイトルと言語を設定する

タイトルと言語の指定によりコンテキストが提供されます。これは、ドキュメントに名前と音声を与えるようなものです。

//ドキュメントのタイトルと言語を設定する
taggedContent.SetTitle("Tagged Pdf Document");
taggedContent.SetLanguage("en-US");

これで、ドキュメントに ID が付与されました。

ステップ5: ルート要素を取得する

すべての構造には基礎が必要ですね。ここでは、ルート構造要素を設定します。

//ルート構造要素を取得する (ドキュメント)
StructureElement rootElement = taggedContent.RootElement;

このルート要素は、ドキュメント構造の最上位レベルとして機能します。

ステップ6: 論理構造セクションを作成する

セクションはコンテンツを論理的に整理するのに役立ちます。本の章のように、セクションを 1 つずつ作成してみましょう。

SectElement sect1 = taggedContent.CreateSectElement();
rootElement.AppendChild(sect1);
SectElement sect2 = taggedContent.CreateSectElement();
rootElement.AppendChild(sect2);

これらの行により、 2 つのセクションが追加されました。

ステップ7: セクションにDiv要素を追加する

div 要素は、章内の段落またはセクションと考えることができます。これらのセクションにコンテンツを追加して、内容を充実させましょう。

DivElement div11 = taggedContent.CreateDivElement();
sect1.AppendChild(div11);
DivElement div12 = taggedContent.CreateDivElement();
sect1.AppendChild(div12);

ここでは、最初のセクションの下に 2 つの div 要素を追加しました。

ステップ8: 次のセクションにアート要素を追加する

では、アート要素を取り入れて芸術的な雰囲気を加えてみましょう。

ArtElement art21 = taggedContent.CreateArtElement();
sect2.AppendChild(art21);
ArtElement art22 = taggedContent.CreateArtElement();
sect2.AppendChild(art22);

番目のセクションに、画像やグラフィックを保持できる 2 つのアート要素を作成しました。

ステップ9: アート要素の下にさらにdiv要素を追加する

さらに div 要素を追加して、これらのアート要素にコンテンツを追加してみましょう。

DivElement div211 = taggedContent.CreateDivElement();
art21.AppendChild(div211);
DivElement div212 = taggedContent.CreateDivElement();
art21.AppendChild(div212);
DivElement div221 = taggedContent.CreateDivElement();
art22.AppendChild(div221);
DivElement div222 = taggedContent.CreateDivElement();
art22.AppendChild(div222);

ここでは、さらに 4 つの div を追加しました。各 div は、芸術的なディスプレイを埋め尽くす小さなコンパートメントと考えてください。

ステップ10: 別のセクションを作成する

これで終わりではありません! さらに多くのコンテンツを保持するために 3 番目のセクションを追加します。

SectElement sect3 = taggedContent.CreateSectElement();
rootElement.AppendChild(sect3);

ここに、埋められるべきもう一つの空白の章があります!

ステップ11: 最後のセクションにDiv要素を追加する

最後に、最後のセクションにコンテンツを埋め込む必要があります。

DivElement div31 = taggedContent.CreateDivElement();
sect3.AppendChild(div31);

このように、ドキュメントには構造化されたコンテンツが詰め込まれます。

ステップ12: ドキュメントを保存する

大変な作業が終わったら、作品を保存する時間です。書き終えた本を棚に置くのと同じだと考えてください。

//タグ付き PDF ドキュメントを保存
document.Save(dataDir + "StructureElementsTree.pdf");

このコマンドは、新しく構造化された PDF ドキュメントを指定されたディレクトリに保存します。

結論

Aspose.PDF for .NET で構造要素ツリーを作成することは、建物の骨組みを構築するようなものです。各ステップは前のステップに基づいて構築され、堅牢で整理されたドキュメントが作成されます。これで、PDF をより効率的に管理し、アクセシビリティを向上させることができます。レポート、ユーザーマニュアル、またはその他のドキュメントを扱う場合でも、コンテンツを正しく構造化することは大きなメリットです。

よくある質問

Aspose.PDF for .NET とは何ですか?

Aspose.PDF for .NET は、.NET アプリケーションで PDF ドキュメントを作成、操作、管理するために使用される強力なライブラリです。

Aspose.PDF を使い始めるにはどうすればよいですか?

まずはライブラリをダウンロードしてくださいAspose ウェブサイト.NET 環境で設定します。

購入前に Aspose.PDF をテストできますか?

はい！無料でお試しいただけます。無料トライアル.

Aspose.PDF に関するヘルプはどこで見つかりますか?

サポートについては、Aspose フォーラム質問したり、洞察を共有したりできる場所です。

一時ライセンスを申請するにはどうすればいいですか?

一時免許を申請することができますここ.

構造要素を作成するテーブル要素を作成する