列と行を操作する
テーブルの動作をより詳細に制御するには、列と行を操作する方法を学習してください。
テーブル要素インデックス {#find-the-index-of-table-elements} を検索する
列、行、セルは、インデックスによって選択したドキュメント ノードにアクセスすることによって管理されます。ノードのインデックスを検索するには、親ノードから要素タイプのすべての子ノードを収集し、IndexOf メソッドを使用してコレクション内の目的のノードのインデックスを検索します。
ドキュメント内の表のインデックスを検索する
場合によっては、ドキュメント内の特定の表に変更を加える必要があるかもしれません。これを行うには、インデックスによってテーブルを参照できます。
次のコード例は、ドキュメント内のテーブルのインデックスを取得する方法を示しています。
テーブル内の行のインデックスを検索する
同様に、選択したテーブルの特定の行を変更する必要がある場合があります。これを行うには、インデックスによって行を参照することもできます。
次のコード例は、テーブル内の行のインデックスを取得する方法を示しています。
行内のセルのインデックスを見つける
最後に、特定のセルに変更を加える必要がある場合がありますが、これはセル インデックスによって行うこともできます。
次のコード例は、行内のセルのインデックスを取得する方法を示しています。
列の操作
Aspose.Words Document Object Model (DOM) では、Table ノードは Row ノードと Cell ノードで構成されます。したがって、Aspose.Words の Document オブジェクト モデルには、Word ドキュメントと同様に、列の概念がありません。
設計上、Microsoft Word と Aspose.Words のテーブル行は完全に独立しており、基本的なプロパティと操作はテーブルの行とセルにのみ含まれています。これにより、テーブルにいくつかの興味深い属性を持たせることができます。
- 表の各行にはまったく異なる数のセルを含めることができます
- 垂直方向では、各行のセルの幅を変えることができます。
- 行形式やセル数が異なる表を結合することが可能
列に対して実行される操作はすべて、実際には列に適用されているように見える方法で行セルを一括して変更することによって操作を実行する「ショートカット」です。つまり、同じテーブルの行のセル インデックスを反復処理するだけで、列に対する操作を実行できます。
次のコード例は、テーブルの「列」を構成するセルを収集するファサード クラスを証明することで、そのような操作を簡素化します。
次のコード例は、テーブルに空の列を挿入する方法を示しています。
次のコード例は、ドキュメント内のテーブルから列を削除する方法を示しています。
行をヘッダー行として指定
テーブルの最初の行を最初のページでのみヘッダー行として繰り返すか、テーブルが複数に分割されている場合は各ページで繰り返すかを選択できます。 Aspose.Words では、HeadingFormat プロパティを使用して、すべてのページでヘッダー行を繰り返すことができます。
複数のヘッダー行がテーブルの先頭に連続して配置されている場合は、複数のヘッダー行をマークすることもできます。これを行うには、HeadingFormat プロパティをこれらの行に適用する必要があります。
次のコード例は、後続のページで繰り返されるヘッダー行を含むテーブルを構築する方法を示しています。
テーブルと行がページをまたがらないようにする
表の内容を複数のページに分割すべきではない場合があります。たとえば、タイトルが表の上にある場合は、適切な外観を維持するために、タイトルと表を常に同じページ上にまとめて配置する必要があります。
この機能を実現するには、次の 2 つの個別の手法が役立ちます。
Allow row break across pages、テーブル行に適用されますKeep with next。表のセル内の段落に適用されます。
デフォルトでは、上記のプロパティは無効になっています。
行がページをまたがらないようにする
これには、行のセル内のコンテンツがページ全体に分割されないように制限することが含まれます。 Microsoft Word では、これはテーブルのプロパティの下に「ページをまたがる行の分割を許可する」オプションとして表示されます。 Aspose.Words では、これは Row の RowFormat オブジェクトの下にプロパティ RowFormat.AllowBreakAcrossPages として見つかります。
次のコード例は、テーブル内の各行のページ間での行の分割を無効にする方法を示しています。
表がページをまたがらないようにする
テーブルがページ間で分割されないようにするには、テーブル内に含まれるコンテンツを一緒に保持することを指定する必要があります。
これを行うために、Aspose.Words はユーザーがテーブルを選択し、テーブル セル内の段落ごとに KeepWithNext パラメータを true に有効にするメソッドを使用します。例外はテーブルの最後の段落で、false に設定する必要があります。
次のコード例は、テーブルを同じページ上にまとめて配置するように設定する方法を示しています。