テーブルを作成する
Aspose.Words を使用すると、ユーザーはドキュメント内にテーブルを最初から作成でき、そのためのいくつかの異なる方法が提供されます。この記事では、各方法を使用して書式設定された表を文書に追加する方法の詳細と、記事の最後で各方法の比較を説明します。
デフォルトのテーブルスタイル
新しく作成されたテーブルには、Microsoft Word で使用されるものと同様のデフォルト値が与えられます。
| テーブルのプロパティ | Aspose.Wordsのデフォルト |
|---|---|
Border Style |
Single |
Border Width |
1/2 pt |
Border Color |
Black |
Left and Right Padding |
5.4 pts |
AutoFit Mode |
AutoFit to Window |
Allow AutoFit |
True |
DocumentBuilder でテーブルを作成する
Aspose.Words では、ユーザーは DocumentBuilder を使用してドキュメント内にテーブルを作成できます。テーブルを作成するための基本的なアルゴリズムは次のとおりです。
- StartTable でテーブルを開始します
- InsertCell を使用してテーブルにセルを追加します。これにより、自動的に新しい行が開始されます
- 必要に応じて、CellFormat プロパティを使用してセルの書式設定を指定します
- Writeln、InsertImage などの適切な DocumentBuilder メソッドを使用してセルの内容を挿入します。
- 行が完成するまでステップ 2 ～ 4 を繰り返します。
- EndRow を呼び出して現在の行を終了します
- 必要に応じて、RowFormat プロパティを使用して行の書式設定を指定します
- テーブルが完成するまでステップ 2 ～ 7 を繰り返します。
- EndTable を呼び出してテーブルの構築を完了します
重要な詳細:
- StartTable はセル内で呼び出すこともでき、その場合はセル内でネストされたテーブルの作成が開始されます。
- InsertCell を呼び出した後、新しいセルが作成され、DocumentBuilder クラスの他のメソッドを使用して追加したコンテンツはすべて現在のセルに追加されます。同じ行に新しいセルを作成するには、InsertCell を再度呼び出します。
- EndRow の直後および行の終わりの直後に InsertCell が呼び出された場合、テーブルは新しい行に続きます。
- テーブルを終了する EndTable メソッドは、EndRow を呼び出した後に 1 回だけ呼び出す必要があります。 EndTable を呼び出すと、カーソルが現在のセルからテーブルの直後の位置に移動します。
テーブルを作成するプロセスは、次の図で明確に見ることができます。
次のコード例は、デフォルトの書式設定で DocumentBuilder を使用して単純なテーブルを作成する方法を示しています。
次のコード例は、DocumentBuilder を使用して書式設定されたテーブルを作成する方法を示しています。
次のコード例は、DocumentBuilder を使用してネストされたテーブルを挿入する方法を示しています。
DOM (Document Object Model) 経由でテーブルを作成する
特定の位置に新しい Table ノードを追加することで、テーブルを DOM に直接挿入できます。
テーブル ノードの作成直後は、テーブル自体が完全に空である、つまり行やセルがまだ含まれていないことに注意してください。テーブルに行とセルを挿入するには、適切な Row および Cell 子ノードを DOM に追加します。
次のコード例は、適切な子ノードをドキュメント ツリーに追加して、新しいテーブルを最初から作成する方法を示しています。
HTMLからテーブルを作成する
Aspose.Words は、InsertHtml メソッドを使用した HTML ソースからドキュメントへのコンテンツの挿入をサポートしています。入力は、完全な HTML ページまたは部分的なスニペットにすることができます。
InsertHtml メソッドを使用すると、<table>、<tr>、<td> などのテーブル タグを介してドキュメントにテーブルを挿入できます。
次のコード例は、HTML タグを含む文字列からドキュメントに表を挿入する方法を示しています。
既存のテーブルのコピーを挿入する
ドキュメント内の既存の表に基づいて表を作成する必要がある場合がよくあります。すべての書式設定を保持したままテーブルを複製する最も簡単な方法は、Clone メソッドを使用してテーブル ノードのクローンを作成することです。
同じ手法を使用して、既存の行またはセルのコピーをテーブルに追加できます。
次のコード例は、ノード コンストラクターを使用してテーブルを複製する方法を示しています。
次のコード例は、テーブルの最後の行のクローンを作成し、それをテーブルに追加する方法を示しています。
データ ソースのレコードごとに動的に増加するテーブルをドキュメント内に作成する場合、上記の方法はお勧めできません。代わりに、リージョンで Mail merge を使用すると、目的の出力をより簡単に実現できます。このテクニックについて詳しくは、Mail Merge とリージョン セクションをご覧ください。
テーブルの作成方法を比較する
Aspose.Words には、ドキュメント内に新しいテーブルを作成するためのいくつかの方法が用意されています。各方法には独自の長所と短所があるため、どちらを使用するかは特定の状況によって決まります。
テーブルを作成するこれらの方法を詳しく見て、その長所と短所を比較してみましょう。
| 方法 | 利点 | 短所 |
|---|---|---|
DocumentBuilder経由 |
表やその他のドキュメントコンテンツを挿入するための標準的な方法 | 同じビルダー インスタンスで同時に多くの種類のテーブルを作成するのが難しい場合がある |
| DOM経由 | DocumentBuilder を使用せずにノードを直接作成して DOM に挿入する周囲のコードとの適合性が向上します。 | テーブルは「空」で作成されます。ほとんどの操作を実行する前に、EnsureMinimum を呼び出して不足している子ノードを作成する必要があります。 |
| HTMLから | <table>、<tr>、<td>などのタグを使用してHTMLソースから新しいテーブルを作成できます |
考えられるすべての Microsoft Word テーブル形式を HTML に適用できるわけではありません |
| 既存のテーブルのクローン作成 | すべての行とセルの書式設定を保持したまま、既存のテーブルのコピーを作成できます。 | テーブルを使用できるようにするには、適切な子ノードを削除する必要があります。 |