page_break_before property
ParagraphFormat.page_break_before property
True if a page break is forced before the paragraph.
@property
def page_break_before(self) -> bool:
...
@page_break_before.setter
def page_break_before(self, value: bool):
...
Examples
Shows how to create paragraphs with page breaks at the beginning.
doc = aw.Document()
builder = aw.DocumentBuilder(doc=doc)
# Set this flag to "true" to apply a page break to each paragraph's beginning
# that the document builder will create under this ParagraphFormat configuration.
# The first paragraph will not receive a page break.
# Leave this flag as "false" to start each new paragraph on the same page
# as the previous, provided there is sufficient space.
builder.paragraph_format.page_break_before = page_break_before
builder.writeln('Paragraph 1.')
builder.writeln('Paragraph 2.')
layout_collector = aw.layout.LayoutCollector(doc)
paragraphs = doc.first_section.body.paragraphs
if page_break_before:
self.assertEqual(1, layout_collector.get_start_page_index(paragraphs[0]))
self.assertEqual(2, layout_collector.get_start_page_index(paragraphs[1]))
else:
self.assertEqual(1, layout_collector.get_start_page_index(paragraphs[0]))
self.assertEqual(1, layout_collector.get_start_page_index(paragraphs[1]))
doc.save(file_name=ARTIFACTS_DIR + 'ParagraphFormat.PageBreakBefore.docx')
See Also
- module aspose.words
- class ParagraphFormat