no_space_between_paragraphs_of_same_style property

ParagraphFormat.no_space_between_paragraphs_of_same_style property

When True, ParagraphFormat.space_before and ParagraphFormat.space_after will be ignored between the paragraphs of the same style.

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

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

Remarks

This setting only takes affect when applied to a paragraph style. If applied to a paragraph directly, it has no effect.

Examples

Shows how to apply no spacing between paragraphs with the same style.

doc = aw.Document()
builder = aw.DocumentBuilder(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 "no_space_between_paragraphs_of_same_style" flag to "True" to apply
# no spacing between paragraphs with the same style, which will group similar paragraphs.
# Leave the "no_space_between_paragraphs_of_same_style" 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(ARTIFACTS_DIR + "ParagraphFormat.paragraph_spacing_same_style.docx")

See Also

• module aspose.words
• class ParagraphFormat