Aspose.Words for .NET使用表格教程之水平和垂直合并表格中單元格

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

接下來(lái)我們將進(jìn)入“使用格式”的介紹，其中包括應(yīng)用格式、介紹和創(chuàng)建表、添加和拆分表以及使用列和行。本文將為大家講解如何水平和垂直合并表格中單元格。

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

表格中的垂直和水平合并單元格

MS Word中的表是一組獨(dú)立的行。每行具有一組獨(dú)立于其他行的單元格的單元格。因此，MS Word的表中沒(méi)有邏輯“列”。“第一列”類(lèi)似于“表中每一行的一組第一單元格”。 例如，可能有一個(gè)表格，其中第一行包含兩個(gè)單元格：2cm和1cm，第二行包含不同的兩個(gè)單元格：寬度為1cm和2cm。

HTML中的表格具有本質(zhì)上不同的結(jié)構(gòu)：每行具有相同數(shù)量的單元格，并且（對(duì)于問(wèn)題而言很重要）每個(gè)單元格具有對(duì)應(yīng)列的寬度，同一列中的所有單元格都具有相同的寬度。

如果CellFormat.HorizontalMerge和CellFormat.VerticalMerge返回不正確的值，請(qǐng)使用下面的代碼示例。下面的示例演示單元格的水平和垂直合并。

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

// Create visitor
SpanVisitor visitor = new SpanVisitor(doc);

// Accept visitor
doc.Accept(visitor);

/// <summary>
/// Helper class that contains collection of rowinfo for each row
/// </summary>
public class TableInfo
{
    public List<RowInfo> Rows
    {
        get { return mRows; }
    }

    private List<RowInfo> mRows = new List<RowInfo>();
}

/// <summary>
/// Helper class that contains collection of cellinfo for each cell
/// </summary>
public class RowInfo
{
    public List<CellInfo> Cells
    {
        get { return mCells; }
    }

    private List<CellInfo> mCells = new List<CellInfo>();
}

/// <summary>
/// Helper class that contains info about cell. currently here is only colspan and rowspan
/// </summary>
public class CellInfo
{
    public CellInfo(int colSpan, int rowSpan)
    {
        mColSpan = colSpan;
        mRowSpan = rowSpan;
    }

    public int ColSpan
    {
        get { return mColSpan; }
    }

    public int RowSpan
    {
        get { return mRowSpan; }
    }

    private int mColSpan = 0;
    private int mRowSpan = 0;
}

public class SpanVisitor : DocumentVisitor
{

    /// <summary>
    /// Creates new SpanVisitor instance
    /// </summary>
    /// <param name="doc">Is document which we should parse</param>
    public SpanVisitor(Document doc)
    {
        //從文檔中獲取表的集合
        mWordTables = doc.GetChildNodes(NodeType.Table, true);

        //將文檔轉(zhuǎn)換為HTML
        //我們將解析HTML以確定每個(gè)單元格的rowpan和colspan
        MemoryStream htmlStream = new MemoryStream();

        HtmlSaveOptions options = new HtmlSaveOptions();
        options.ImagesFolder = Path.GetTempPath();

        doc.Save(htmlStream, options);

        //將 HTML加載到XML文檔中
        XmlDocument xmlDoc = new XmlDocument();
        htmlStream.Position = 0;
        xmlDoc.Load(htmlStream);

        //獲取HTML文檔中的表集合
        XmlNodeList tables = xmlDoc.DocumentElement.SelectNodes("// Table");

        foreach (XmlNode table in tables)
        {
            TableInfo tableInf = new TableInfo();
            //獲取表中的行集合
            XmlNodeList rows = table.SelectNodes("tr");

            foreach (XmlNode row in rows)
            {
                RowInfo rowInf = new RowInfo();

                //獲取單元格的集合
                XmlNodeList cells = row.SelectNodes("td");

                foreach (XmlNode cell in cells)
                {
                    //確定當(dāng)前單元格的行跨度和列跨度
                    XmlAttribute colSpanAttr = cell.Attributes["colspan"];
                    XmlAttribute rowSpanAttr = cell.Attributes["rowspan"];

                    int colSpan = colSpanAttr == null ? 0 : Int32.Parse(colSpanAttr.Value);
                    int rowSpan = rowSpanAttr == null ? 0 : Int32.Parse(rowSpanAttr.Value);

                    CellInfo cellInf = new CellInfo(colSpan, rowSpan);
                    rowInf.Cells.Add(cellInf);
                }

                tableInf.Rows.Add(rowInf);
            }

            mTables.Add(tableInf);
        }
    }

    public override VisitorAction VisitCellStart(Cell cell)
    {
        // 確定當(dāng)前表的索引
        int tabIdx = mWordTables.IndexOf(cell.ParentRow.ParentTable);

        //確定當(dāng)前行的索引
        int rowIdx = cell.ParentRow.ParentTable.IndexOf(cell.ParentRow);

        //確定當(dāng)前單元格的索引
        int cellIdx = cell.ParentRow.IndexOf(cell);

        //確定當(dāng)前單元格的colspan和rowpan
        int colSpan = 0;
        int rowSpan = 0;
        if (tabIdx < mTables.Count &&
            rowIdx < mTables[tabIdx].Rows.Count &&
            cellIdx < mTables[tabIdx].Rows[rowIdx].Cells.Count)
        {
            colSpan = mTables[tabIdx].Rows[rowIdx].Cells[cellIdx].ColSpan;
            rowSpan = mTables[tabIdx].Rows[rowIdx].Cells[cellIdx].RowSpan;
        }

        Console.WriteLine("{0}.{1}.{2} colspan={3}\t rowspan={4}", tabIdx, rowIdx, cellIdx, colSpan, rowSpan);

        return VisitorAction.Continue;
    }
    private List<TableInfo> mTables = new List<TableInfo>();
    private NodeCollection mWordTables = null;
}

轉(zhuǎn)換為水平合并的單元格

在最新版本的MS Word中，單元格按其寬度水平合并。而合并標(biāo)志是在較舊的技術(shù)中使用的，例如Cell.CellFormat.HorizontalMerge。當(dāng)單元按其寬度水平合并時(shí)，將不使用合并標(biāo)志  ，并且也無(wú)法檢測(cè)到哪些單元被合并。Aspose.Words提供ConvertToHorizontallyMergedCells方法，以將按其寬度水平合并的單元格轉(zhuǎn)換為通過(guò)標(biāo)志水平合并的單元格。它只是  轉(zhuǎn)換表并在需要時(shí)添加新的單元格。下面的代碼示例演示上述方法的工作。

Document doc = new Document();

Table table = doc.FirstSection.Body.Tables[0];
table.ConvertToHorizontallyMergedCells();   //合并的單元格具有適當(dāng)?shù)暮喜?biāo)志

ASPOSE技術(shù)交流QQ群（642018183）已開(kāi)通，各類(lèi)資源及時(shí)分享，歡迎交流討論！

如果您對(duì)Aspose有任何需求和疑難，記得掃描下方二維碼告訴我們哦~