create_save_options method
Contents
[
Hide
]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):
...
| Parameter | Type | Description |
|---|---|---|
| save_format | SaveFormat | The 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):
...
| Parameter | Type | Description |
|---|---|---|
| file_name | str | The 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(file_name='Document.DefaultTemplate.docx')
options.default_template = MY_DIR + 'Business brochure.dotx'
doc.save(file_name=ARTIFACTS_DIR + 'Document.DefaultTemplate.docx', save_options=options)
See Also
- module aspose.words.saving
- class SaveOptions