WordML2003SaveOptions class
WordML2003SaveOptions class
Can be used to specify additional options when saving a document into the SaveFormat.WORD_ML format. To learn more, visit the Specify Save Options documentation article.
Remarks
At the moment provides only the WordML2003SaveOptions.save_format property, but in the future may have other options added.
Inheritance: WordML2003SaveOptions → SaveOptions
Constructors
Name | Description |
---|---|
WordML2003SaveOptions() | The default constructor. |
Properties
Name | Description |
---|---|
allow_embedding_post_script_fonts | Gets or sets a boolean value indicating whether to allow embedding fonts with PostScript outlines when embedding TrueType fonts in a document upon it is saved. The default value is False .(Inherited from SaveOptions) |
default_template | Gets or sets path to default template (including filename). Default value for this property is empty string (). (Inherited from SaveOptions) |
dml_3d_effects_rendering_mode | Gets or sets a value determining how 3D effects are rendered. (Inherited from SaveOptions) |
dml_effects_rendering_mode | Gets or sets a value determining how DrawingML effects are rendered. (Inherited from SaveOptions) |
dml_rendering_mode | Gets or sets a value determining how DrawingML shapes are rendered. (Inherited from SaveOptions) |
export_generator_name | When True , causes the name and version of Aspose.Words to be embedded into produced files. Default value is True .(Inherited from SaveOptions) |
iml_rendering_mode | Gets or sets a value determining how ink (InkML) objects are rendered. (Inherited from SaveOptions) |
memory_optimization | Gets or sets value determining if memory optimization should be performed before saving the document. Default value for this property is False .(Inherited from SaveOptions) |
pretty_format | When True , pretty formats output where applicable. Default value is False .(Inherited from SaveOptions) |
progress_callback | Called during saving a document and accepts data about saving progress. (Inherited from SaveOptions) |
save_format | Specifies the format in which the document will be saved if this save options object is used. Can only be SaveFormat.WORD_ML. |
temp_folder | Specifies the folder for temporary files used when saving to a DOC or DOCX file. By default this property is None and no temporary files are used.(Inherited from SaveOptions) |
update_created_time_property | Gets or sets a value determining whether the BuiltInDocumentProperties.created_time property is updated before saving. Default value is False ;(Inherited from SaveOptions) |
update_fields | Gets or sets a value determining if fields of certain types should be updated before saving the document to a fixed page format. Default value for this property is True .(Inherited from SaveOptions) |
update_last_printed_property | Gets or sets a value determining whether the BuiltInDocumentProperties.last_printed property is updated before saving. (Inherited from SaveOptions) |
update_last_saved_time_property | Gets or sets a value determining whether the BuiltInDocumentProperties.last_saved_time property is updated before saving. (Inherited from SaveOptions) |
use_anti_aliasing | Gets or sets a value determining whether or not to use anti-aliasing for rendering. (Inherited from SaveOptions) |
use_high_quality_rendering | Gets or sets a value determining whether or not to use high quality (i.e. slow) rendering algorithms. (Inherited from SaveOptions) |
Methods
Name | Description |
---|---|
create_save_options(save_format) | Creates a save options object of a class suitable for the specified save format. (Inherited 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. (Inherited from SaveOptions) |
Examples
Shows how to manage output document’s raw content.
doc = aw.Document()
builder = aw.DocumentBuilder(doc)
builder.writeln("Hello world!")
# Create a "WordML2003SaveOptions" object to pass to the document's "save" method
# to modify how we save the document to the WordML save format.
options = aw.saving.WordML2003SaveOptions()
self.assertEqual(aw.SaveFormat.WORD_ML, options.save_format)
# Set the "pretty_format" property to "True" to apply tab character indentation and
# newlines to make the output document's raw content easier to read.
# Set the "pretty_format" property to "False" to save the document's raw content in one continuous body of the text.
options.pretty_format = pretty_format
doc.save(ARTIFACTS_DIR + "WordML2003SaveOptions.pretty_format.xml", options)
with open(ARTIFACTS_DIR + "WordML2003SaveOptions.pretty_format.xml", "rb") as file:
file_contents = file.read().decode('utf-8')
if pretty_format:
expected = (
"<o:DocumentProperties>\r\n\t\t" +
"<o:Revision>1</o:Revision>\r\n\t\t" +
"<o:TotalTime>0</o:TotalTime>\r\n\t\t" +
"<o:Pages>1</o:Pages>\r\n\t\t" +
"<o:Words>0</o:Words>\r\n\t\t" +
"<o:Characters>0</o:Characters>\r\n\t\t" +
"<o:Lines>1</o:Lines>\r\n\t\t" +
"<o:Paragraphs>1</o:Paragraphs>\r\n\t\t" +
"<o:CharactersWithSpaces>0</o:CharactersWithSpaces>\r\n\t\t" +
"<o:Version>11.5606</o:Version>\r\n\t" +
"</o:DocumentProperties>")
self.assertTrue(expected in file_contents)
else:
expected = (
"<o:DocumentProperties><o:Revision>1</o:Revision><o:TotalTime>0</o:TotalTime><o:Pages>1</o:Pages>" +
"<o:Words>0</o:Words><o:Characters>0</o:Characters><o:Lines>1</o:Lines><o:Paragraphs>1</o:Paragraphs>" +
"<o:CharactersWithSpaces>0</o:CharactersWithSpaces><o:Version>11.5606</o:Version></o:DocumentProperties>")
self.assertTrue(expected in file_contents)
Shows how to manage memory optimization.
doc = aw.Document()
builder = aw.DocumentBuilder(doc)
builder.writeln("Hello world!")
# Create a "WordML2003SaveOptions" object to pass to the document's "save" method
# to modify how we save the document to the WordML save format.
options = aw.saving.WordML2003SaveOptions()
# Set the "memory_optimization" flag to "True" to decrease memory consumption
# during the document's saving operation at the cost of a longer saving time.
# Set the "memory_optimization" flag to "False" to save the document normally.
options.memory_optimization = memory_optimization
doc.save(ARTIFACTS_DIR + "WordML2003SaveOptions.memory_optimization.xml", options)
See Also
- module aspose.words.saving
- class SaveOptions