Aspose.Words for .NET使用表格教程之處理合并的單元格

推薦閱讀：【Aspose.Words for .NET使用表格教程之應用格式——將格式應用于表，行和單元格】

Aspose.Words For .Net是一種高級Word文檔處理API，用于執行各種文檔管理和操作任務。API支持生成，修改，轉換，呈現和打印文檔，而無需在跨平臺應用程序中直接使用Microsoft Word。此外，API支持所有流行的Word處理文件格式，并允許將Word文檔導出或轉換為固定布局文件格式和最常用的圖像/多媒體格式。

接下來我們將進入“使用格式”的介紹，其中包括應用格式、介紹和創建表、添加和拆分表以及使用列和行。本文將為大家講解如何在表格中運用自動調整設置。

>>Aspose.Words for .NET更新至最新版v19.10，歡迎下載體驗

在一個表中，幾個單元格可以合并到一個單元格中。當某些行需要標題或跨表寬度的大塊文本時，此功能很有用。這只能通過將表中的某些單元格合并為一個單元格來實現。當使用所有輸入格式（包括導入HTML內容）時，Aspose.Words支持合并的單元格。

Aspose.Words中的合并單元格

在Aspose.Words中，合并的單元格由CellFormat.HorizontalMerge和CellFormat.VerticalMerge表示。所述CellFormat.HorizontalMerge屬性描述如果所述細胞是細胞的水平合并的一部分。同樣，CellFormat.VerticalMerge屬性描述單元格是否是單元格垂直合并的一部分。這些屬性的值定義了單元格的合并行為。

• 合并單元格序列中的第一個單元格將具有CellMerge.First。
• 任何隨后合并的單元格將具有CellMerge.Previous。
• 未合并的單元格將具有CellMerge.None。

檢查單元格是否合并

要檢查某個單元格是否為合并單元格序列的一部分，我們只需檢查CellFormat.HorizontalMerge和CellFormat.VerticalMerge屬性。 下面的示例顯示單元格的水平和垂直合并類型。您可以從此處下載該示例的模板文件。

Document doc = new Document(dataDir + "Table.MergedCells.doc");

// Retrieve the first table in the document.
Table table = (Table)doc.GetChild(NodeType.Table, 0, true);

foreach (Row row in table.Rows)
{
    foreach (Cell cell in row.Cells)
    {
        Console.WriteLine(PrintCellMergeType(cell));
    }
}

合并表格中的單元格

使用相同的技術來設置表中單元格的合并行為。使用DocumentBuilder構建具有合并單元格的表時，需要為每個單元格設置適當的合并類型。另外，您必須記住清除合并設置，否則表中的所有單元格將被合并。可以通過將適當的合并屬性的值設置為CellMerge.None來完成。 下面的示例創建一個具有兩行的表，其中第一行的單元格水平合并。

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.InsertCell();
builder.CellFormat.HorizontalMerge = CellMerge.First;
builder.Write("Text in merged cells.");

builder.InsertCell();
// This cell is merged to the previous and should be empty.
builder.CellFormat.HorizontalMerge = CellMerge.Previous;
builder.EndRow();

builder.InsertCell();
builder.CellFormat.HorizontalMerge = CellMerge.None;
builder.Write("Text in one cell.");

builder.InsertCell();
builder.Write("Text in another cell.");
builder.EndRow();
builder.EndTable();
dataDir = dataDir + "Table.HorizontalMerge_out.doc";

// Save the document to disk.
doc.Save(dataDir);

下面的示例創建一個具有兩列的表格，第一列中的單元格垂直合并。

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.InsertCell();
builder.CellFormat.VerticalMerge = CellMerge.First;
builder.Write("Text in merged cells.");

builder.InsertCell();
builder.CellFormat.VerticalMerge = CellMerge.None;
builder.Write("Text in one cell");
builder.EndRow();

builder.InsertCell();
// This cell is vertically merged to the cell above and should be empty.
builder.CellFormat.VerticalMerge = CellMerge.Previous;

builder.InsertCell();
builder.CellFormat.VerticalMerge = CellMerge.None;
builder.Write("Text in another cell");
builder.EndRow();
builder.EndTable();
dataDir = dataDir + "Table.VerticalMerge_out.doc";

// Save the document to disk.
doc.Save(dataDir);

在不使用構建器的其他情況下（例如在現有表中），以這種方式合并單元可能不是那么簡單。 取而代之的是，我們可以將將合并屬性應用于單元格所涉及的基本操作包裝到一種使任務輕松得多的方法中。 此方法類似于自動合并方法，該方法被稱為合并表中的一系列單元格。 下面的代碼將合并表中從給定單元格到結束單元格的單元格范圍。 此范圍可以跨越許多行或列。 一種合并表中所有單元格在指定單元格范圍內的方法。

internal static void MergeCells(Cell startCell, Cell endCell)
{
    Table parentTable = startCell.ParentRow.ParentTable;

    // Find the row and cell indices for the start and end cell.
    Point startCellPos = new Point(startCell.ParentRow.IndexOf(startCell), parentTable.IndexOf(startCell.ParentRow));
    Point endCellPos = new Point(endCell.ParentRow.IndexOf(endCell), parentTable.IndexOf(endCell.ParentRow));
    // Create the range of cells to be merged based off these indices. Inverse each index if the end cell if before the start cell. 
    Rectangle mergeRange = new Rectangle( System.Math.Min(startCellPos.X, endCellPos.X), System.Math.Min(startCellPos.Y, endCellPos.Y),
        System.Math.Abs(endCellPos.X - startCellPos.X) + 1, System.Math.Abs(endCellPos.Y - startCellPos.Y) + 1);

    foreach (Row row in parentTable.Rows)
    {
        foreach (Cell cell in row.Cells)
        {
            Point currentPos = new Point(row.IndexOf(cell), parentTable.IndexOf(row));

            // Check if the current cell is inside our merge range then merge it.
            if (mergeRange.Contains(currentPos))
            {
                if (currentPos.X == mergeRange.X)
                    cell.CellFormat.HorizontalMerge = CellMerge.First;
                else
                    cell.CellFormat.HorizontalMerge = CellMerge.Previous;

                if (currentPos.Y == mergeRange.Y)
                    cell.CellFormat.VerticalMerge = CellMerge.First;
                else
                    cell.CellFormat.VerticalMerge = CellMerge.Previous;
            }
        }
    }
}

下面的示例合并兩個指定單元格之間的單元格范圍。

// Open the document
Document doc = new Document(dataDir + "Table.Document.doc");

// Retrieve the first table in the body of the first section.
Table table = doc.FirstSection.Body.Tables[0];
           
// We want to merge the range of cells found inbetween these two cells.
Cell cellStartRange = table.Rows[2].Cells[2];
Cell cellEndRange = table.Rows[3].Cells[3];

// Merge all the cells between the two specified cells into one.
MergeCells(cellStartRange, cellEndRange);            
dataDir = dataDir + "Table.MergeCellRange_out.doc";
// Save the document.
doc.Save(dataDir);

ASPOSE技術交流QQ群（642018183）已開通，各類資源及時分享，歡迎交流討論！

掃描關注“慧聚IT”微信公眾號，及時獲取更多產品最新動態及最新資訊