allow_break_across_pages property

RowFormat.allow_break_across_pages property

True if the text in a table row is allowed to split across a page break.

@property
def allow_break_across_pages(self) -> bool:
    ...

@allow_break_across_pages.setter
def allow_break_across_pages(self, value: bool):
    ...

Examples

Shows how to disable rows breaking across pages for every row in a table.

doc = aw.Document(MY_DIR + "Table spanning two pages.docx")
table = doc.first_section.body.tables[0]

# Set the "allow_break_across_pages" property to "False" to keep the row
# in one piece if a table spans two pages, which break up along that row.
# If the row is too big to fit in one page, Microsoft Word will push it down to the next page.
# Set the "allow_break_across_pages" property to "True" to allow the row to break up across two pages.
for row in table:
    row = row.as_row()
    row.row_format.allow_break_across_pages = allow_break_across_pages

doc.save(ARTIFACTS_DIR + "Table.allow_break_across_pages.docx")

See Also

RowFormat.borders property