スタイルテーブル要素

導入

この記事では、Aspose.PDF for .NET を使用してテーブル要素を作成し、スタイルを設定する方法について詳しく説明します。テーブルの構成方法、カスタムスタイルの適用方法、ドキュメントの PDF/UA 準拠の検証方法を学習します。このチュートリアルを終えると、PDF でプロフェッショナルな外観のテーブルを簡単に作成できるようになります。

前提条件

チュートリアルに進む前に、次のものを用意しておく必要があります。

マシンに Visual Studio または同様の IDE がインストールされていること。
アプリケーションを実行するための .NET Framework または .NET Core SDK。
Aspose.PDF for .NETライブラリがダウンロードされ、プロジェクトで参照されます。最新バージョンは以下から入手できます。ここ.
有効なAsposeライセンスまたは一時ライセンスライブラリの全機能を利用できるようになります。

パッケージのインポート

まず、必要な名前空間をプロジェクトにインポートします。

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

これらの名前空間は、コア PDF 操作、タグ付きコンテンツ、表、およびテキスト書式設定をカバーします。

それでは、Aspose.PDF でテーブルを作成し、スタイルを設定するプロセスを詳しく説明しましょう。各セクションを詳しく説明しますので、理解しながら進めてください。

ステップ1: 新しいPDFドキュメントを作成し、タグ付きコンテンツを設定する

この最初のステップでは、空白の PDF ドキュメントを作成し、タグ付けされたコンテンツを設定します。

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

//新しいPDF文書を作成する
Document document = new Document();

//タグ付きコンテンツの設定
ITaggedContent taggedContent = document.TaggedContent;
taggedContent.SetTitle("Example table style");
taggedContent.SetLanguage("en-US");

まず新しいものを作ることから始めますDocumentオブジェクトはPDFを表します。TaggedContentオブジェクトは、ドキュメントの構造を管理し、アクセシビリティ標準への準拠を保証するために使用されます。適切なタグ付けのために、ドキュメントのタイトルと言語を設定します。

ステップ2: ルート要素を定義する

次に、PDF 内のすべてのコンテンツのコンテナーとして機能するルート構造要素を作成します。

//ルート構造要素を取得する
StructureElement rootElement = taggedContent.RootElement;

のRootElementテーブルを含むすべての構造化要素の基本コンテナとして機能します。ドキュメントの構造階層を維持するのに役立ちます。これは、組織化とアクセシビリティの両方にとって重要です。

ステップ3: テーブル要素を作成してスタイルを設定する

ルート要素が設定されたので、TableElement背景色、境界線、配置などのスタイルを適用します。

//テーブル構造要素を作成する
TableElement tableElement = taggedContent.CreateTableElement();
rootElement.AppendChild(tableElement);

//テーブルをスタイリングする
tableElement.BackgroundColor = Color.Beige;
tableElement.Border = new BorderInfo(BorderSide.All, 0.80F, Color.Gray);
tableElement.Alignment = HorizontalAlignment.Center;
tableElement.Broken = TableBroken.Vertical;
tableElement.ColumnAdjustment = ColumnAdjustment.AutoFitToWindow;

私たちはTableElementはテーブル構造を定義します。BackgroundColor, Border 、そしてAlignmentプロパティを使用すると、テーブルの外観をカスタマイズできます。Brokenこのプロパティにより、表がページをまたいで分割される場合、垂直方向に分割されることが保証されます。

ステップ4: 表のサイズとセルのスタイルを設定する

このステップでは、列の数、セルの余白、その他の重要なテーブルプロパティを定義します。

tableElement.ColumnWidths = "80 80 80 80 80";
tableElement.DefaultCellBorder = new BorderInfo(BorderSide.All, 0.50F, Color.DarkBlue);
tableElement.DefaultCellPadding = new MarginInfo(16.0, 2.0, 8.0, 2.0);
tableElement.DefaultCellTextState.ForegroundColor = Color.DarkCyan;
tableElement.DefaultCellTextState.FontSize = 8F;

列幅を指定することで、表の各列の間隔が均一になるようにします。DefaultCellBorder, DefaultCellPadding 、そしてDefaultCellTextState境界線、パディング、テキストの色、フォントサイズなど、セルの既定のスタイルを定義します。

ステップ5: 繰り返し行とカスタムスタイルを追加する

繰り返し行や、ヘッダーやフッターなどの他の特定のテーブル要素のスタイルを定義することもできます。

tableElement.RepeatingRowsCount = 3;
TextState rowStyle = new TextState();
rowStyle.BackgroundColor = Color.LightCoral;
tableElement.RepeatingRowsStyle = rowStyle;

のRepeatingRowsCount表が複数ページにまたがる場合、最初の3行が繰り返されるようにします。RepeatingRowsStyleこれらの行にカスタム背景色を適用します。

ステップ6: 表の見出し、本文、および脚の要素を追加する

次に、表のヘッダー、本文、フッターのセクションを作成し、コンテンツを入力します。

TableTHeadElement tableTHeadElement = tableElement.CreateTHead();
TableTBodyElement tableTBodyElement = tableElement.CreateTBody();
TableTFootElement tableTFootElement = tableElement.CreateTFoot();

//ヘッダー行を作成する
TableTRElement headTrElement = tableTHeadElement.CreateTR();
headTrElement.AlternativeText = "Head Row";
for (int colIndex = 0; colIndex < 5; colIndex++)
{
    TableTHElement thElement = headTrElement.CreateTH();
    thElement.SetText($"Head {colIndex}");
}

//テーブル本体にデータを入力する
for (int rowIndex = 0; rowIndex < 10; rowIndex++)
{
    TableTRElement trElement = tableTBodyElement.CreateTR();
    for (int colIndex = 0; colIndex < 5; colIndex++)
    {
        TableTDElement tdElement = trElement.CreateTD();
        tdElement.SetText($"Cell [{rowIndex}, {colIndex}]");
    }
}

表は、ヘッド、ボディ、フッターの3つの部分に分かれています。まず、ヘッダー行を作成します。TableTHElement列見出しを追加します。次に、表の本体にTableTDElement各セルにその位置を含むラベルを入力します。

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

最後に、PDF ドキュメントを指定されたディレクトリに保存します。

//タグ付けされたPDF文書を保存する
document.Save(dataDir + "StyleTableElement.pdf");

この手順では、スタイル設定されたテーブルを含む PDF ファイルを保存して、ドキュメント作成プロセスを完了します。

ステップ8: PDF/UA準拠を検証する

ドキュメントを保存した後、PDF/UA (ユニバーサルアクセシビリティ) 標準に準拠していることを確認することが重要です。

// PDF/UA準拠を確認する
document = new Document(dataDir + "StyleTableElement.pdf");
bool isPdfUaCompliance = document.Validate(dataDir + "StyleTableElement.xml", PdfFormat.PDF_UA_1);
Console.WriteLine($"PDF/UA compliance: {isPdfUaCompliance}");

ここで、ドキュメントを再読み込みし、PDF/UA 標準に照らして検証します。コンプライアンスにより、PDF がアクセシビリティ要件を満たし、幅広いユーザーに適したものになることが保証されます。

結論

Aspose.PDF for .NET を使用すると、PDF ドキュメントでの表の作成とスタイル設定が簡単かつ直感的に行えます。このチュートリアルで説明されている手順に従うことで、カスタマイズされたスタイルで表を作成し、PDF がアクセシビリティ標準を満たすようにすることができます。レポートを生成する場合でも、構造化されたドキュメントを作成する場合でも、表はデータを明確に提示するための強力なツールです。

よくある質問

表のセル内に画像を追加できますか?

はい、表のセルに画像を挿入するには、Image要素。

列幅を動的に調整するにはどうすればよいですか?

設定できるのはColumnAdjustment財産にAutoFitToWindowコンテンツに応じて列の幅を自動的に調整します。

すべてのドキュメントで PDF/UA 準拠が必須ですか?

必須ではありませんが、高いアクセシビリティ基準を必要とするドキュメントには推奨されます。

特定の行に異なるスタイルを適用できますか?

はい、個々の行やセルを調整することでカスタマイズできます。TextStateまたはBackgroundColor.

タグ付けされたコンテンツを使用する利点は何ですか?

タグ付けされたコンテンツはドキュメントのアクセシビリティを向上させ、PDF/UA などの標準への準拠を確保するのに役立ちます。

テーブルセルのスタイルスタイルテーブル行