---
title: "表のセルを結合する"
---


表内の特定の行には、表の全幅を占める見出しまたは大きなテキスト ブロックが必要な場合があります。テーブルを適切に設計するために、ユーザーは複数のテーブル セルを 1 つにマージできます。 Aspose.Words は、HTML コンテンツのインポートを含むすべての入力形式を操作するときに、結合されたセルをサポートします。

## 表のセルを結合する方法

Aspose.Words では、結合されたセルは [CellFormat](https://reference.aspose.com/words/python-net/aspose.words.tables/cellformat/) クラスの次のプロパティによって表されます。

- セルがセルの水平結合の一部であるかどうかを説明する [HorizontalMerge](https://reference.aspose.com/words/python-net/aspose.words.tables/cellformat/horizontal_merge/)
- セルがセルの垂直結合の一部であるかどうかを説明する [VerticalMerge](https://reference.aspose.com/words/python-net/aspose.words.tables/cellformat/vertical_merge/)

これらのプロパティの値は、セルの結合動作を決定します。

- 結合された一連のセルの最初のセルには [CellMerge.First](https://reference.aspose.com/words/python-net/aspose.words.tables/cellmerge/#first) が含まれます。
- その後マージされたセルには [CellMerge.Previous](https://reference.aspose.com/words/python-net/aspose.words.tables/cellmerge/#previous) が含まれます。
- マージされていないセルには [CellMerge.None](https://reference.aspose.com/words/python-net/aspose.words.tables/cellmerge/#none) が含まれます。

{{% alert color="primary" %}}

既存の文書セルを表にロードすると、セルが結合されて表示されることがあります。ただし、実際には 1 つの長いセルである可能性があり、Microsoft Word がこの方法で結合されたセルをエクスポートする場合があります。これは、個々のセルを操作しようとする場合に混乱を招く可能性がありますが、これがいつ起こるかについては、特定のパターンはないようです。

{{% /alert %}}

## セルが結合されているかどうかを確認する

セルが結合された一連のセルの一部であるかどうかを確認するには、**HorizontalMerge** プロパティと **VerticalMerge** プロパティを確認するだけです。

次のコード例は、水平セルと垂直セルの結合タイプを印刷する方法を示しています。

{{< gist "aspose-words-gists" "b89ea9092bd2486dc056818cf4f73e24" "check-cells-merged.py" >}}

{{% alert color="primary" %}}

この例のサンプル ファイルは [Aspose.Words GitHub](https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET/blob/master/Examples/Data/Table%20with%20merged%20cells.docx) からダウンロードできます。

{{% /alert %}}

## DocumentBuilder 使用時の表のセルの結合

[DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/) で作成されたテーブル内のセルを結合するには、結合が予想されるセルごとに適切な結合タイプ (最初に **CellMerge.First**、次に **CellMerge.Previous**) を設定する必要があります。

また、マージが必要ないセルのマージ設定を忘れずにクリアする必要があります。これを行うには、最初の非マージ セルを **CellMerge.None** に設定します。これを行わないと、テーブル内のすべてのセルが結合されてしまいます。

次のコード例は、最初の行のセルが水平方向に結合された 2 行のテーブルを作成する方法を示しています。

{{< gist "aspose-words-gists" "b89ea9092bd2486dc056818cf4f73e24" "horizontal-merge.py" >}}

次のコード例は、最初の列のセルが垂直方向に結合された 2 列のテーブルを作成する方法を示しています。

{{< gist "aspose-words-gists" "b89ea9092bd2486dc056818cf4f73e24" "vertical-merge.py" >}}

## 他のケースでの表のセルの結合

既存のテーブルなど、**DocumentBuilder** が使用されない他の状況では、前の方法でセルを結合するのはそれほど簡単ではない可能性があります。代わりに、結合プロパティをセルに適用する際の基本的な操作を、タスクをはるかに簡単にするメソッドでラップすることができます。このメソッドは、テーブル内のセル範囲を結合するために呼び出される Merge オートメーション メソッドに似ています。

以下のコードは、指定されたセルから開始して最後のセルで終了する、指定された範囲内の表のセルを結合します。この場合、範囲は複数の行または列にまたがることができます。

{{< gist "aspose-words-gists" "b89ea9092bd2486dc056818cf4f73e24" "merge-cells.py" >}}

次のコード例は、指定した 2 つのセル間のセル範囲を結合する方法を示しています。

{{< gist "aspose-words-gists" "b89ea9092bd2486dc056818cf4f73e24" "merge-cell-range.py" >}}

{{% alert color="primary" %}}

この例のサンプル ファイルは [Aspose.Words GitHub](https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET/blob/master/Examples/Data/Table%20with%20merged%20cells.docx) からダウンロードできます。

{{% /alert %}}

使用しているフレームワークのバージョンによっては、このメソッドを拡張メソッドに変換して改良することができます。この場合、セル上でこのメソッドを直接呼び出して、`cell1.Merge(cell2)` などのセル範囲を結合できます。

## 水平方向に結合されたセルに変換

一部の新しいバージョンの Microsoft Word では、セルが水平方向に結合されるときに結合フラグが使用されなくなったため、どのセルが結合されたのかを検出できない場合があります。ただし、マージ フラグを使用してセルが幅ごとに水平方向に 1 つのセルにマージされる場合、Aspose.Words はセルを変換する `ConvertToHorizontallyMergedCells` メソッドを提供します。このメソッドは、テーブルを変換し、必要に応じて新しいセルを追加するだけです。

次のコード例は、上記のメソッドの動作を示しています。

{{< gist "aspose-words-gists" "b89ea9092bd2486dc056818cf4f73e24" "convert-to-horizontally-merged-cells.py" >}}