export_shapes_as_svg property
HtmlSaveOptions.export_shapes_as_svg property
Controls whether Shape nodes are converted to SVG images when saving
to HTML, MHTML, EPUB or AZW3.
Default value is False
.
@property
def export_shapes_as_svg(self) -> bool:
...
@export_shapes_as_svg.setter
def export_shapes_as_svg(self, value: bool):
...
Remarks
If this option is set to True
, Shape nodes are exported as <svg> elements.
Otherwise, they are rendered to bitmaps and are exported as <img> elements.
Examples
Shows how to export shape as scalable vector graphics.
doc = aw.Document()
builder = aw.DocumentBuilder(doc)
text_box = builder.insert_shape(aw.drawing.ShapeType.TEXT_BOX, 100.0, 60.0)
builder.move_to(text_box.first_paragraph)
builder.write("My text box")
# When we save the document to HTML, we can pass a SaveOptions object
# to determine how the saving operation will export text box shapes.
# If we set the "export_shapes_as_svg" flag to "True",
# the save operation will convert shapes with text into SVG objects.
# If we set the "export_shapes_as_svg" flag to "False",
# the save operation will convert shapes with text into images.
options = aw.saving.HtmlSaveOptions()
options.export_shapes_as_svg = export_shape_as_svg
doc.save(ARTIFACTS_DIR + "HtmlSaveOptions.export_text_box.html", options)
with open(ARTIFACTS_DIR + "HtmlSaveOptions.export_text_box.html", "rt", encoding="utf-8") as file:
out_doc_contents = file.read()
if export_shape_as_svg:
self.assertIn(
"<span style=\"-aw-left-pos:0pt; -aw-rel-hpos:column; -aw-rel-vpos:paragraph; -aw-top-pos:0pt; -aw-wrap-type:inline\">" +
"<svg xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\" version=\"1.1\" width=\"133\" height=\"80\">",
out_doc_contents)
else:
self.assertIn(
"<p style=\"margin-top:0pt; margin-bottom:0pt\">" +
"<img src=\"HtmlSaveOptions.export_text_box.001.png\" width=\"136\" height=\"83\" alt=\"\" " +
"style=\"-aw-left-pos:0pt; -aw-rel-hpos:column; -aw-rel-vpos:paragraph; -aw-top-pos:0pt; -aw-wrap-type:inline\" />" +
"</p>", out_doc_contents)
See Also
- module aspose.words.saving
- class HtmlSaveOptions