create_save_options method

create_save_options(save_format)

Creates a save options object of a class suitable for the specified save format.

def create_save_options(self, save_format: aspose.words.SaveFormat):
    ...
ParameterTypeDescription
save_formatSaveFormatThe save format for which to create a save options object.

Returns

An object of a class that derives from SaveOptions.

create_save_options(file_name)

Creates a save options object of a class suitable for the file extension specified in the given file name.

def create_save_options(self, file_name: str):
    ...
ParameterTypeDescription
file_namestrThe extension of this file name determines the class of the save options object to create.

Returns

An object of a class that derives from SaveOptions.

Examples

Shows an option to optimize memory consumption when rendering large documents to PDF.

doc = aw.Document(MY_DIR + "Rendering.docx")

# Create a "PdfSaveOptions" object that we can pass to the document's "save" method
# to modify how that method converts the document to .PDF.
save_options = aw.saving.SaveOptions.create_save_options(aw.SaveFormat.PDF)

# Set the "memory_optimization" property to "True" to lower the memory footprint of large documents' saving operations
# at the cost of increasing the duration of the operation.
# Set the "memory_optimization" property to "False" to save the document as a PDF normally.
save_options.memory_optimization = memory_optimization

doc.save(ARTIFACTS_DIR + "PdfSaveOptions.memory_optimization.pdf", save_options)

Shows how to set a default template for documents that do not have attached templates.

doc = aw.Document()

# Enable automatic style updating, but do not attach a template document.
doc.automatically_update_styles = True

self.assertEqual("", doc.attached_template)

# Since there is no template document, the document had nowhere to track style changes.
# Use a SaveOptions object to automatically set a template
# if a document that we are saving does not have one.
options = aw.saving.SaveOptions.create_save_options("Document.default_template.docx")
options.default_template = MY_DIR + "Business brochure.dotx"

doc.save(ARTIFACTS_DIR + "Document.default_template.docx", options)

See Also