CellMerge enumeration

CellMerge enumeration

Specifies how a cell in a table is merged with other cells.

Members

Name	Description
NONE	The cell is not merged.
FIRST	The cell is the first cell in a range of merged cells.
PREVIOUS	The cell is merged to the previous cell horizontally or vertically.

Examples

Shows how to merge table cells vertically.

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

# Insert a cell into the first column of the first row.
# This cell will be the first in a range of vertically merged cells.
builder.insert_cell()
builder.cell_format.vertical_merge = aw.tables.CellMerge.FIRST
builder.write("Text in merged cells.")

# Insert a cell into the second column of the first row, then end the row.
# Also, configure the builder to disable vertical merging in created cells.
builder.insert_cell()
builder.cell_format.vertical_merge = aw.tables.CellMerge.NONE
builder.write("Text in unmerged cell.")
builder.end_row()

# Insert a cell into the first column of the second row.
# Instead of adding text contents, we will merge this cell with the first cell that we added directly above.
builder.insert_cell()
builder.cell_format.vertical_merge = aw.tables.CellMerge.PREVIOUS

# Insert another independent cell in the second column of the second row.
builder.insert_cell()
builder.cell_format.vertical_merge = aw.tables.CellMerge.NONE
builder.write("Text in unmerged cell.")
builder.end_row()
builder.end_table()

doc.save(ARTIFACTS_DIR + "CellFormat.vertical_merge.docx")

Shows how to merge table cells horizontally.

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

# Insert a cell into the first column of the first row.
# This cell will be the first in a range of horizontally merged cells.
builder.insert_cell()
builder.cell_format.horizontal_merge = aw.tables.CellMerge.FIRST
builder.write("Text in merged cells.")

# Insert a cell into the second column of the first row. Instead of adding text contents,
# we will merge this cell with the first cell that we added directly to the left.
builder.insert_cell()
builder.cell_format.horizontal_merge = aw.tables.CellMerge.PREVIOUS
builder.end_row()

# Insert two more unmerged cells to the second row.
builder.cell_format.horizontal_merge = aw.tables.CellMerge.NONE
builder.insert_cell()
builder.write("Text in unmerged cell.")
builder.insert_cell()
builder.write("Text in unmerged cell.")
builder.end_row()
builder.end_table()

doc.save(ARTIFACTS_DIR + "CellFormat.horizontal_merge.docx")

Prints the horizontal and vertical merge type of a cell.

def test_check_cells_merged(self):

    doc = aw.Document(MY_DIR + "Table with merged cells.docx")
    table = doc.first_section.body.tables[0]

    for row in table.rows:
        row = row.as_row()
        for cell in row.cells:
            cell = cell.as_cell()
            print(self.print_cell_merge_type(cell))

@staticmethod
def print_cell_merge_type(cell: aw.tables.Cell) -> str:

    is_horizontally_merged = cell.cell_format.horizontal_merge != aw.tables.CellMerge.NONE
    is_vertically_merged = cell.cell_format.vertical_merge != aw.tables.CellMerge.NONE
    cell_location = f"R{cell.parent_row.parent_table.index_of(cell.parent_row) + 1}, C{cell.parent_row.index_of(cell) + 1}"

    if is_horizontally_merged and is_vertically_merged:
        return f"The cell at {cell_location} is both horizontally and vertically merged"
    if is_horizontally_merged:
        return f"The cell at {cell_location} is horizontally merged."
    if is_vertically_merged:
        return f"The cell at {cell_location} is vertically merged"
    return f"The cell at {cell_location} is not merged"

See Also

• module aspose.words.tables