Browse our Products

Aspose.Words for Python via .NET 22.12 Release Notes

Major Features

There are 74 improvements and fixes in this regular monthly release. The most notable are:

  • Implemented an abbility to specify the particular Margin type for the given section.
  • The new public properties ThemeColor and TintAndShade were introduced.
  • Implemented rendering of the linear trendline formula for DrawingML charts rendering.
  • Implemented optimization that significantly reduces the depth of graphics state nesting when rendering to PDF to maintain specification compliance.

Full List of Issues Covering all Changes in this Release (Reported by .NET Users)

WORDSNET-14305RTF To PDF conversion issue with cell’s text renderingNew Feature
WORDSNET-23931Parameterized Margins property in PageSetupNew Feature
WORDSNET-10449DOC to PDF conversion issue with content positionNew Feature
WORDSNET-19791Imitate MS Word behavior when field update in header/footer affects container table height or widthNew Feature
WORDSNET-23681Word to PDF conversion - equation is mssing from the chartNew Feature
WORDSNET-24441Consider implementation of Border.ThemeColorNew Feature
WORDSNET-23747Table left indent in AW model does not match MS Word UI for an xml documentEnhancement
WORDSNET-24620Some font names in Noto fallback settings are outdatedEnhancement
WORDSNET-24402Differences in comparisonEnhancement
WORDSNET-24549ArgumentOutOfRangeException is thrown upon using ExtractPages methodBug
WORDSNET-24305Third level numbering is not preserved after appending documentBug
WORDSNET-24537DOCX to PDF: Wrong character positioningBug
WORDSNET-24293DOCX to PDF: Character orientation does not retain upon conversionBug
WORDSNET-24373“No table of figures entries found” is shown after updating fields in the documentBug
WORDSNET-24280Page numbers in TOC are incorrect after renderingBug
WORDSNET-19585Incorrect bottom-margin relative shape position in headerBug
WORDSNET-24112The table borders are not preserved during DOCX-HTML-DOCX roundtripBug
WORDSNET-23200EML to PDF conversion: validation fails: Maximum depth of graphics state nesting by q and Q operators exceededBug
WORDSNET-24630InvalidOperationException: Target width and heightBug
WORDSNET-24545ArgumentOutOfRangeException: Specified argument was out of the range of valid valuesBug
WORDSNET-24533NullReferenceException in GetForm()Bug
WORDSNET-24631InvalidOperationException: Incorrect CropBoxBug
WORDSNET-24609Unknown format on loading TXT fileBug
WORDSNET-24603“Unsupported file format: Unknown” on loading TXT fileBug
WORDSNET-22858Shape is converted from DML to VML while exporting document to DOCXBug
WORDSNET-24338Aspose.Words hangs upon updating fieldsBug
WORDSNET-24336NullReferenceException is thrown upon calling UpdateFieldsBug
WORDSNET-24546NullReferenceException when converting DOCX to PDFBug
WORDSNET-24513Bookmarks with duplicated names are lost in building bolocksBug
WORDSNET-24464Incorrect graphics in converted DOCX fileBug
WORDSNET-24466Footnote text is partially missingBug
WORDSNET-24443Revisions are rendered improperlyBug
WORDSNET-24224InvalidOperationException is thrown upon comparing documentBug
WORDSNET-24585Wrong export of hidden text into MarkdownBug
WORDSNET-24583SDT placeholder text is visible after rendering documentBug
WORDSNET-24529Hidden SDT becomes visible after open/save documentBug
WORDSNET-24519Text color in chart legend is changed after renderingBug
WORDSNET-24596Document.UpdateFields does not update RD fieldBug
WORDSNET-24579FileCorruptedException is thrown upon loading DOCX documentBug
WORDSNET-19866TOC color changes to blue when converting Word to HTMLBug
WORDSNET-24538ArgumentException is thrown upon updating fieldsBug
WORDSNET-24510Ideographic text inside list label is incorrectly rotated in vertical directionBug
WORDSNET-24570NullReferenceException is thrown upon rendering documentBug
WORDSNET-17524Document.UpdateFields method does not update page numbers of XE entries in INDEX fieldBug
WORDSNET-24591Chinese character are invisible after renderingBug
WORDSNET-24567Document compare throws System.InvalidOperationExceptionBug
WORDSNET-24170The name of group slice of PieOfPie chart is not rendered after converting to PDFBug
WORDSNET-24130Incorrect calculation of the chart space rectangle if manual layout is setBug
WORDSNET-24506Font of TOC entries changes after DOCX to PDF conversionBug
WORDSNET-24468Exception on loading text fileBug
WORDSNET-16405Document.Compare does not mimic MS Word behaviorBug
WORDSNET-16874The compared output contains improper table revisionsBug
WORDSNET-24312DOCX to HTML: InvalidOperationExceptionBug
WORDSNET-24151An error occurs when trying to save a document to EPUB with default optionsBug
WORDSNET-24571Part of table is moved to previous page upon renderingBug
WORDSNET-22225Performance issue during comparing Text filesBug
WORDSNET-24313FileFormatDetector doesn’t recognize PDF files with garbage at the beginningBug
WORDSNET-24551Aspose.Words.Shaping.HarfBuzz does not have a strong nameBug
WORDSNET-24511Redundant whitespace is added to the field value after updateBug
WORDSNET-24536FileCorruptedException is thrown upon loading DOCX documentBug
WORDSNET-24542Symbols are rendered as tofuBug
WORDSNET-24297DOC to PDF: Overlapping imagesBug
WORDSNET-24247Section Header becomes text-wrapped around iconsBug

Full List of Issues Covering all Changes in this Release (Reported by Java Users)

WORDSNET-24363Phonetic Guide is not exported to TXTBug
WORDSNET-24634Aspose.Words selects wrong font upon renderinngBug
WORDSNET-21893List labels are lost after DOCX to PDF conversionBug
WORDSNET-24428NullReferenceException is thrown upon rendering documentBug
WORDSNET-24386Chinese justified text looks improperly after open/save documentBug
WORDSNET-24476Page number style is incorrect in PDF after comparing documentsBug
WORDSNET-24586Comment range is changed after comparing documentsBug
WORDSNET-24475NullReferenceException is thrown upon rendering document with chartBug
WORDSNET-23907Table Alignment Issue in converting RTF files to PDFBug
WORDSNET-24565Replaced shape is not catched by compare methodBug
WORDSNET-24431Watermark is displayed over the textBug

Public API and Backward Incompatible Changes

This section lists public API changes that were introduced in Aspose.Words for Python via .NET 22.12. It includes not only new and obsoleted public methods, but also a description of any changes in the behavior behind the scenes in Aspose.Words which may affect existing code. Any behavior introduced that could be seen as regression and modifies the existing behavior is especially important and is documented here.

Added new public properties ThemeColor and TintAndShade

Related issue: WORDSNET-24441

A new public property theme_color has been added to class Border:

    def theme_color(self) -> aspose.words.themes.ThemeColor:
    # Gets or sets the theme color in the applied color scheme that is associated with this Border object.

A new public property tint_and_shade has been added to class Border:

    def tint_and_shade(self) -> float:
    # Gets or sets a double value that lightens or darkens a color.

Use Case: Explains how to work with theme_color and tint_and_shade.

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

top_border =
top_border.line_width = 0.5
# Sets the value of ThemeColor.
top_border.theme_color = aw.themes.ThemeColor.ACCENT1

bottom_border = builder.paragraph_format.borders.bottom
bottom_border.line_width = 0.5
# Sets the value of ThemeColor.
bottom_border.theme_color = aw.themes.ThemeColor.ACCENT2

left_border = builder.paragraph_format.borders.left
left_border.line_width = 1.5
# Sets the value of ThemeColor.
left_border.theme_color = aw.themes.ThemeColor.ACCENT3
# Sets the lightens value.
left_border.tint_and_shade = 0.25

right_border = builder.paragraph_format.borders.right
right_border.line_width = 1.5
# Sets the value of ThemeColor.
right_border.theme_color = aw.themes.ThemeColor.ACCENT4
# Sets the darkens value.
right_border.tint_and_shade = -0.125

builder.write("Lorem Ipsum")"output.docx")

Added public property PageSetup.Margins

Related issue: WORDSNET-23931

A new public property margins has been added to the PageSetup class:

    def margins(self) -> aspose.words.Margins:
    # Returns or sets preset aspose.words.Margins of the page.

A new public enum Margins has been introduced:

class Margins
# Specifies preset margins.

Use Case: Explains how to get and set the specified aspose.words.Margin type for the given section.

doc = aw.Document("in.docx")
# Getting the current Margin type.
if doc.sections[1].page_setup.margins == aw.Margins.NORMAL:
    # Setting the specified Margin type.
    doc.sections[1].page_setup.margins = aw.Margins.MIRRORED