space_after property
ParagraphFormat.space_after property
Gets or sets the amount of spacing (in points) after the paragraph.
@property
def space_after(self) -> float:
...
@space_after.setter
def space_after(self, value: float):
...
Exceptions
exception | condition |
---|---|
RuntimeError (Proxy error(ArgumentOutOfRangeException)) | Throws when argument was out of the range of valid values. |
Remarks
Has no effect when ParagraphFormat.space_after_auto is True
.
Valid values range from 0 to 1584 inclusive.
Examples
Shows how to set automatic paragraph spacing.
doc = aw.Document()
builder = aw.DocumentBuilder(doc=doc)
# Apply a large amount of spacing before and after paragraphs that this builder will create.
builder.paragraph_format.space_before = 24
builder.paragraph_format.space_after = 24
# Set these flags to "true" to apply automatic spacing,
# effectively ignoring the spacing in the properties we set above.
# Leave them as "false" will apply our custom paragraph spacing.
builder.paragraph_format.space_after_auto = auto_spacing
builder.paragraph_format.space_before_auto = auto_spacing
# Insert two paragraphs that will have spacing above and below them and save the document.
builder.writeln('Paragraph 1.')
builder.writeln('Paragraph 2.')
doc.save(file_name=ARTIFACTS_DIR + 'ParagraphFormat.ParagraphSpacingAuto.docx')
Shows how to apply no spacing between paragraphs with the same style.
doc = aw.Document()
builder = aw.DocumentBuilder(doc=doc)
# Apply a large amount of spacing before and after paragraphs that this builder will create.
builder.paragraph_format.space_before = 24
builder.paragraph_format.space_after = 24
# Set the "NoSpaceBetweenParagraphsOfSameStyle" flag to "true" to apply
# no spacing between paragraphs with the same style, which will group similar paragraphs.
# Leave the "NoSpaceBetweenParagraphsOfSameStyle" flag as "false"
# to evenly apply spacing to every paragraph.
builder.paragraph_format.no_space_between_paragraphs_of_same_style = no_space_between_paragraphs_of_same_style
builder.paragraph_format.style = doc.styles.get_by_name('Normal')
builder.writeln(f'Paragraph in the "{builder.paragraph_format.style.name}" style.')
builder.writeln(f'Paragraph in the "{builder.paragraph_format.style.name}" style.')
builder.writeln(f'Paragraph in the "{builder.paragraph_format.style.name}" style.')
builder.paragraph_format.style = doc.styles.get_by_name('Quote')
builder.writeln(f'Paragraph in the "{builder.paragraph_format.style.name}" style.')
builder.writeln(f'Paragraph in the "{builder.paragraph_format.style.name}" style.')
builder.paragraph_format.style = doc.styles.get_by_name('Normal')
builder.writeln(f'Paragraph in the "{builder.paragraph_format.style.name}" style.')
builder.writeln(f'Paragraph in the "{builder.paragraph_format.style.name}" style.')
doc.save(file_name=ARTIFACTS_DIR + 'ParagraphFormat.ParagraphSpacingSameStyle.docx')
See Also
- module aspose.words
- class ParagraphFormat