suppress_auto_hyphens property

ParagraphFormat.suppress_auto_hyphens property

Specifies whether the current paragraph should be exempted from any hyphenation which is applied in the document settings.

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

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

Examples

Shows how to suppress hyphenation for a paragraph.

aw.Hyphenation.register_dictionary('de-CH', MY_DIR + 'hyph_de_CH.dic')
self.assertTrue(aw.Hyphenation.is_dictionary_registered('de-CH'))
# Open a document containing text with a locale matching that of our dictionary.
# When we save this document to a fixed page save format, its text will have hyphenation.
doc = aw.Document(MY_DIR + 'German text.docx')
# We can set the "suppress_auto_hyphens" property to "True" to disable hyphenation
# for a specific paragraph while keeping it enabled for the rest of the document.
# The default value for this property is "False",
# which means every paragraph by default uses hyphenation if any is available.
doc.first_section.body.first_paragraph.paragraph_format.suppress_auto_hyphens = suppress_auto_hyphens
doc.save(ARTIFACTS_DIR + 'ParagraphFormat.suppress_hyphens.pdf')

See Also

ParagraphFormat.style_name property ParagraphFormat.suppress_line_numbers property