def merge(self, other_cell):
"""Create merged cell from this cell to *other_cell*.
This cell and *other_cell* specify opposite corners of the merged
cell range. Either diagonal of the cell region may be specified in
either order, e.g. self=bottom-right, other_cell=top-left, etc.
Raises |ValueError| if the specified range already contains merged
cells anywhere within its extents or if *other_cell* is not in the
same table as *self*.
"""
tc_range = TcRange(self._tc, other_cell._tc)
if not tc_range.in_same_table:
raise ValueError("other_cell from different table")
if tc_range.contains_merged_cell:
raise ValueError("range contains one or more merged cells")
tc_range.move_content_to_origin()
row_count, col_count = tc_range.dimensions
for tc in tc_range.iter_top_row_tcs():
tc.rowSpan = row_count
for tc in tc_range.iter_left_col_tcs():
tc.gridSpan = col_count
for tc in tc_range.iter_except_left_col_tcs():
tc.hMerge = True
for tc in tc_range.iter_except_top_row_tcs():
tc.vMerge = True
def merge(self, other_cell):
"""Create merged cell from this cell to *other_cell*.
This cell and *other_cell* specify opposite corners of the merged
cell range. Either diagonal of the cell region may be specified in
either order, e.g. self=bottom-right, other_cell=top-left, etc.
Raises |ValueError| if the specified range already contains merged
cells anywhere within its extents or if *other_cell* is not in the
same table as *self*.
"""
tc_range = TcRange(self._tc, other_cell._tc)
if not tc_range.in_same_table:
raise ValueError("other_cell from different table")
if tc_range.contains_merged_cell:
raise ValueError("range contains one or more merged cells")
tc_range.move_content_to_origin()
row_count, col_count = tc_range.dimensions
for tc in tc_range.iter_top_row_tcs():
tc.rowSpan = row_count
for tc in tc_range.iter_left_col_tcs():
tc.gridSpan = col_count
for tc in tc_range.iter_except_left_col_tcs():
tc.hMerge = True
for tc in tc_range.iter_except_top_row_tcs():
tc.vMerge = True
def it_can_migrate_range_content_to_origin_cell(self, move_fixture):
tc, other_tc, expected_text = move_fixture
tc_range = TcRange(tc, other_tc)
tc_range.move_content_to_origin()
assert tc.text == expected_text
assert other_tc.text == ""
def it_can_migrate_range_content_to_origin_cell(self, move_fixture):
tc, other_tc, expected_text = move_fixture
tc_range = TcRange(tc, other_tc)
tc_range.move_content_to_origin()
assert tc.text == expected_text
assert other_tc.text == ""