スタイルテーブル要素

この詳細なチュートリアルでは、提供されている C# ソースコードを段階的に説明し、Aspose.PDF for .NET を使用して配列要素をフォーマットします。配列要素のスタイルとプロパティをカスタマイズする方法を理解するには、以下の手順に従ってください。

ステップ 1: 環境をセットアップする

始める前に、Aspose.PDF for .NET を使用するように開発環境が構成されていることを確認してください。これには、Aspose.PDF ライブラリのインストールと、それを参照するようにプロジェクトを構成することが含まれます。

ステップ 2: ドキュメントの作成

このステップでは、新しいドキュメントオブジェクト Aspose.PDF を作成します。

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

//書類作成
Document document = new Document();
ITaggedContent taggedContent = document.TaggedContent;
taggedContent.SetTitle("Example of table formatting");
taggedContent.SetLanguage("fr-FR");

新しいドキュメントを作成し、ドキュメントのタイトルと言語を設定しました。

ステップ 3: ルート構造要素の取得

このステップでは、ドキュメントのルート構造要素を取得します。

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

配列要素のコンテナとして機能するルート構造要素を取得しました。

ステップ 4: 配列構造要素の作成

次に、ドキュメント用に新しいテーブル構造要素を作成しましょう。

//配列構造要素を作成する
TableElement tableElement = taggedContent.CreateTableElement();
rootElement.AppendChild(tableElement);

新しい配列構造要素を作成し、ルート構造要素に追加しました。

ステップ 5: 配列要素のスタイルとプロパティをカスタマイズする

このステップでは、配列要素のスタイルとプロパティをカスタマイズします。

//配列要素のスタイルとプロパティをカスタマイズする
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. 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;
tableElement. DefaultColumnWidth = "70";
tableElement. IsBroken = false;
tableElement.IsBordersIncluded = true;
tableElement. Left = 0F;
tableElement. Top = 40F;
tableElement.RepeatingColumnsCount = 2;
tableElement.RepeatingRowsCount = 3;

//繰り返し行のスタイルをカスタマイズする
TextState rowStyle = new TextState();
rowStyle.BackgroundColor = Color.LightCoral;
tableElement.RepeatingRowsStyle = rowStyle;

背景色、境界線、配置、デフォルトのセルスタイル、余白、列幅など、さまざまなプロパティを使用してテーブル要素をカスタマイズしました。

ステップ 6: テーブルのヘッダー、本文、フッターを追加する

次に、テーブルのヘッダー、本文、フッターをテーブル要素に追加しましょう。

//テーブルヘッダーを追加する
TableTHeadElement tableTHeadElement = tableElement.CreateTHead();
TableTBodyElement tableTBodyElement = tableElement.CreateTBody();
TableTFootElement tableTFootElement = tableElement.CreateTFoot();

//テーブル内の行と列の数
int rowCount = 10;
int colCount = 5;
int rowIndex;
int colIndex;

//テーブルのヘッダー行を作成する
TableTRElement headTrElement = tableTHeadElement.CreateTR();
headTrElement.AlternativeText = "Header Row";

for (colIndex = 0; colIndex < colCount; colIndex++)
{
     TableTHElement theElement = headTrElement.CreateTH();
     theElement.SetText(string.Format("Header {0}", colIndex));
}

//テーブル本体の行を追加します
for (rowIndex = 0; rowIndex < rowCount; rowIndex++)
{
     TableTRElement trElement = tableTBodyElement.CreateTR();
     trElement.AlternativeText = string.Format("Row {0}", rowIndex);

     for (colIndex = 0; colIndex < colCount; colIndex++)
     {
         TableTDElement tdelement = trElement.CreateTD();
         tdElement.SetText(string.Format("Cell [{0}, {1}]", rowIndex, colIndex));
     }
}

//表の基礎線を追加する
TableTRElement footTrElement = tableTFootElement.CreateTR();
footTrElement.AlternativeText = "Footline";

for (colIndex = 0; colIndex < colCount; colIndex++)
{
     TableTDElement tdElement = footTrElement.CreateTD();
     tdElement.SetText(string.Format("Foot {0}", colIndex));
}

対応する要素を使用して、ヘッダー、本文行、およびフッター行をテーブルに追加しました。

ステップ 7: タグ付けされた PDF ドキュメントを保存する

スタイル付きテーブル要素を使用してドキュメントを作成したので、それをタグ付き 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(string.Format("PDF/UA Compliance: {0}", isPdfUaCompliance));

タグ付けされた PDF ドキュメントをアップロードし、XML レポートを生成してその PDF/UA 準拠を検証しました。

Aspose.PDF for .NET を使用したスタイルテーブル要素のサンプルソースコード


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

//文書の作成
Document document = new Document();
ITaggedContent taggedContent = document.TaggedContent;
taggedContent.SetTitle("Example table style");
taggedContent.SetLanguage("en-US");

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

//テーブル構造要素の作成
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.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;
tableElement.DefaultColumnWidth = "70";
tableElement.IsBroken = false;
tableElement.IsBordersIncluded = true;
tableElement.Left = 0F;
tableElement.Top = 40F;
tableElement.RepeatingColumnsCount = 2;
tableElement.RepeatingRowsCount = 3;
TextState rowStyle = new TextState();
rowStyle.BackgroundColor = Color.LightCoral;
tableElement.RepeatingRowsStyle = rowStyle;
TableTHeadElement tableTHeadElement = tableElement.CreateTHead();
TableTBodyElement tableTBodyElement = tableElement.CreateTBody();
TableTFootElement tableTFootElement = tableElement.CreateTFoot();
int rowCount = 10;
int colCount = 5;
int rowIndex;
int colIndex;
TableTRElement headTrElement = tableTHeadElement.CreateTR();
headTrElement.AlternativeText = "Head Row";
for (colIndex = 0; colIndex < colCount; colIndex++)
{
	TableTHElement thElement = headTrElement.CreateTH();
	thElement.SetText(String.Format("Head {0}", colIndex));
}
for (rowIndex = 0; rowIndex < rowCount; rowIndex++)
{
	TableTRElement trElement = tableTBodyElement.CreateTR();
	trElement.AlternativeText = String.Format("Row {0}", rowIndex);
	for (colIndex = 0; colIndex < colCount; colIndex++)
	{
		TableTDElement tdElement = trElement.CreateTD();
		tdElement.SetText(String.Format("Cell [{0}, {1}]", rowIndex, colIndex));
	}
}
TableTRElement footTrElement = tableTFootElement.CreateTR();
footTrElement.AlternativeText = "Foot Row";
for (colIndex = 0; colIndex < colCount; colIndex++)
{
	TableTDElement tdElement = footTrElement.CreateTD();
	tdElement.SetText(String.Format("Foot {0}", colIndex));
}

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

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

結論

このチュートリアルでは、Aspose.PDF for .NET を使用して配列要素をフォーマットする方法を学びました。テーブル要素のスタイルとプロパティをカスタマイズし、ヘッダー、本文行、フッターを追加し、タグ付けされた PDF ドキュメントを保存して、PDF/UA 準拠を検証しました。

よくある質問

Q: Aspose.PDF for .NET を使用して配列要素をフォーマットするこのチュートリアルの目的は何ですか?

A: このチュートリアルの目的は、Aspose.PDF for .NET を使用して PDF ドキュメント内の配列要素をフォーマットするプロセスをガイドすることです。配列要素のスタイルとプロパティをカスタマイズするのに役立つ段階的な手順と C# ソースコードの例が提供されています。

Q: このチュートリアルを実行するための前提条件は何ですか?

A: 始める前に、Aspose.PDF for .NET を使用するように開発環境が設定されていることを確認してください。これには、Aspose.PDF ライブラリをインストールし、それを参照するようにプロジェクトを構成することが含まれます。

Q: Aspose.PDF for .NET を使用して新しい PDF ドキュメントを作成し、そのタイトルと言語を設定するにはどうすればよいですか?

A: 新しい PDF ドキュメントを作成するには、Document Aspose.PDF ライブラリのオブジェクト。チュートリアルで提供されている C# ソースコードは、ドキュメントを作成し、そのタイトルと言語プロパティを設定する方法を示しています。

Q: PDF ドキュメント内のルート構造要素の重要性は何ですか?

A: ルート構造要素は他の構造要素のコンテナとして機能し、PDF ドキュメントのコンテンツの整理と分類に役立ちます。文書の論理構造を確立する上で重要な役割を果たします。

Q: Aspose.PDF for .NET を使用して配列構造要素を作成およびカスタマイズするにはどうすればよいですか?

A: 配列構造要素は、CreateTableElement()方法。チュートリアルのソースコードでは、背景色、境界線、配置、列幅など、テーブル要素のさまざまなプロパティをカスタマイズする例が提供されています。

Q: 配列要素内のテーブルセルのスタイルとプロパティをカスタマイズできますか?

A: はい、このチュートリアルでは、ヘッダー、本文行、フッターを含むテーブル要素全体のスタイルとプロパティをカスタマイズする方法について説明します。ただし、テーブルの個々のセルのカスタマイズについては特に説明しません。

Q: テーブル要素にヘッダー、本文行、フッターを追加するにはどうすればよいですか?

A: このチュートリアルでは、Aspose.PDF for .NET が提供する適切なメソッドを使用して、ヘッダー、本文行、フッターを作成し、テーブル要素に追加する方法を説明します。

Q: PDF/UA 準拠とは何ですか? タグ付けされた PDF ドキュメントについてそれを検証するにはどうすればよいですか?

A: PDF/UA 準拠により、PDF ドキュメントがアクセシビリティ標準に準拠していることが保証され、障害のあるユーザーにとってもアクセシビリティが向上します。このチュートリアルでは、Validate()メソッドを使用して XML 準拠レポートを生成します。

Q: これらの概念を独自の .NET アプリケーションに組み込むにはどうすればよいですか?

A: 提供されている C# ソースコードの例は、独自の .NET アプリケーションで配列要素の書式設定を実装するためのガイドとして使用できます。要件に合わせてコードを変更および調整し、プロジェクトに統合します。

Q: PDF ドキュメント内の配列要素の書式設定に関して推奨されるベストプラクティスはありますか?

A: 配列要素 (テーブル) をフォーマットするときは、コンテンツの読みやすさとアクセシビリティを考慮してください。明確で読みやすいフォント、適切な色を使用し、一貫したレイアウトを維持します。 PDF/UA への準拠を検証して、アクセシビリティ基準が満たされていることを確認します。

Q: PDF ドキュメントのカスタマイズのために、Aspose.PDF for .NET の他のどの機能を探索できますか?

A: Aspose.PDF for .NET は、テキスト操作、画像挿入、フォームフィールド管理、デジタル署名、注釈などを含む、PDF ドキュメントのカスタマイズのためのさまざまな機能を提供します。追加の機能については、公式ドキュメントとリソースを参照してください。

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