keep_legacy_control_chars property

OoxmlSaveOptions.keep_legacy_control_chars property

Keeps original representation of legacy control characters.

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

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

Examples

Shows how to support legacy control characters when converting to .docx.

doc = aw.Document(file_name=MY_DIR + 'Legacy control character.doc')
# When we save the document to an OOXML format, we can create an OoxmlSaveOptions object
# and then pass it to the document's saving method to modify how we save the document.
# Set the "KeepLegacyControlChars" property to "true" to preserve
# the "ShortDateTime" legacy character while saving.
# Set the "KeepLegacyControlChars" property to "false" to remove
# the "ShortDateTime" legacy character from the output document.
so = aw.saving.OoxmlSaveOptions(aw.SaveFormat.DOCX)
so.keep_legacy_control_chars = keep_legacy_control_chars
doc.save(file_name=ARTIFACTS_DIR + 'OoxmlSaveOptions.KeepLegacyControlChars.docx', save_options=so)
doc = aw.Document(file_name=ARTIFACTS_DIR + 'OoxmlSaveOptions.KeepLegacyControlChars.docx')
self.assertEqual('\x13date \\@ "MM/dd/yyyy"\x14\x15\x0c' if keep_legacy_control_chars else '\x1e\x0c', doc.first_section.body.get_text())

keep_legacy_control_chars property

OoxmlSaveOptions.keep_legacy_control_chars property

Examples

See Also