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)
Key | Summary | Category |
---|---|---|
WORDSNET-14305 | RTF To PDF conversion issue with cell’s text rendering | New Feature |
WORDSNET-23931 | Parameterized Margins property in PageSetup | New Feature |
WORDSNET-10449 | DOC to PDF conversion issue with content position | New Feature |
WORDSNET-19791 | Imitate MS Word behavior when field update in header/footer affects container table height or width | New Feature |
WORDSNET-23681 | Word to PDF conversion - equation is mssing from the chart | New Feature |
WORDSNET-24441 | Consider implementation of Border.ThemeColor | New Feature |
WORDSNET-23747 | Table left indent in AW model does not match MS Word UI for an xml document | Enhancement |
WORDSNET-24620 | Some font names in Noto fallback settings are outdated | Enhancement |
WORDSNET-24402 | Differences in comparison | Enhancement |
WORDSNET-24549 | ArgumentOutOfRangeException is thrown upon using ExtractPages method | Bug |
WORDSNET-24305 | Third level numbering is not preserved after appending document | Bug |
WORDSNET-24537 | DOCX to PDF: Wrong character positioning | Bug |
WORDSNET-24293 | DOCX to PDF: Character orientation does not retain upon conversion | Bug |
WORDSNET-24373 | “No table of figures entries found” is shown after updating fields in the document | Bug |
WORDSNET-24280 | Page numbers in TOC are incorrect after rendering | Bug |
WORDSNET-19585 | Incorrect bottom-margin relative shape position in header | Bug |
WORDSNET-24112 | The table borders are not preserved during DOCX-HTML-DOCX roundtrip | Bug |
WORDSNET-23200 | EML to PDF conversion: validation fails: Maximum depth of graphics state nesting by q and Q operators exceeded | Bug |
WORDSNET-24630 | InvalidOperationException: Target width and height | Bug |
WORDSNET-24545 | ArgumentOutOfRangeException: Specified argument was out of the range of valid values | Bug |
WORDSNET-24533 | NullReferenceException in GetForm() | Bug |
WORDSNET-24631 | InvalidOperationException: Incorrect CropBox | Bug |
WORDSNET-24609 | Unknown format on loading TXT file | Bug |
WORDSNET-24603 | “Unsupported file format: Unknown” on loading TXT file | Bug |
WORDSNET-22858 | Shape is converted from DML to VML while exporting document to DOCX | Bug |
WORDSNET-24338 | Aspose.Words hangs upon updating fields | Bug |
WORDSNET-24336 | NullReferenceException is thrown upon calling UpdateFields | Bug |
WORDSNET-24546 | NullReferenceException when converting DOCX to PDF | Bug |
WORDSNET-24513 | Bookmarks with duplicated names are lost in building bolocks | Bug |
WORDSNET-24464 | Incorrect graphics in converted DOCX file | Bug |
WORDSNET-24466 | Footnote text is partially missing | Bug |
WORDSNET-24443 | Revisions are rendered improperly | Bug |
WORDSNET-24224 | InvalidOperationException is thrown upon comparing document | Bug |
WORDSNET-24585 | Wrong export of hidden text into Markdown | Bug |
WORDSNET-24583 | SDT placeholder text is visible after rendering document | Bug |
WORDSNET-24529 | Hidden SDT becomes visible after open/save document | Bug |
WORDSNET-24519 | Text color in chart legend is changed after rendering | Bug |
WORDSNET-24596 | Document.UpdateFields does not update RD field | Bug |
WORDSNET-24579 | FileCorruptedException is thrown upon loading DOCX document | Bug |
WORDSNET-19866 | TOC color changes to blue when converting Word to HTML | Bug |
WORDSNET-24538 | ArgumentException is thrown upon updating fields | Bug |
WORDSNET-24510 | Ideographic text inside list label is incorrectly rotated in vertical direction | Bug |
WORDSNET-24570 | NullReferenceException is thrown upon rendering document | Bug |
WORDSNET-17524 | Document.UpdateFields method does not update page numbers of XE entries in INDEX field | Bug |
WORDSNET-24591 | Chinese character are invisible after rendering | Bug |
WORDSNET-24567 | Document compare throws System.InvalidOperationException | Bug |
WORDSNET-24170 | The name of group slice of PieOfPie chart is not rendered after converting to PDF | Bug |
WORDSNET-24130 | Incorrect calculation of the chart space rectangle if manual layout is set | Bug |
WORDSNET-24506 | Font of TOC entries changes after DOCX to PDF conversion | Bug |
WORDSNET-24468 | Exception on loading text file | Bug |
WORDSNET-16405 | Document.Compare does not mimic MS Word behavior | Bug |
WORDSNET-16874 | The compared output contains improper table revisions | Bug |
WORDSNET-24312 | DOCX to HTML: InvalidOperationException | Bug |
WORDSNET-24151 | An error occurs when trying to save a document to EPUB with default options | Bug |
WORDSNET-24571 | Part of table is moved to previous page upon rendering | Bug |
WORDSNET-22225 | Performance issue during comparing Text files | Bug |
WORDSNET-24313 | FileFormatDetector doesn’t recognize PDF files with garbage at the beginning | Bug |
WORDSNET-24551 | Aspose.Words.Shaping.HarfBuzz does not have a strong name | Bug |
WORDSNET-24511 | Redundant whitespace is added to the field value after update | Bug |
WORDSNET-24536 | FileCorruptedException is thrown upon loading DOCX document | Bug |
WORDSNET-24542 | Symbols are rendered as tofu | Bug |
WORDSNET-24297 | DOC to PDF: Overlapping images | Bug |
WORDSNET-24247 | Section Header becomes text-wrapped around icons | Bug |
Full List of Issues Covering all Changes in this Release (Reported by Java Users)
Key | Summary | Category |
---|---|---|
WORDSNET-24363 | Phonetic Guide is not exported to TXT | Bug |
WORDSNET-24634 | Aspose.Words selects wrong font upon renderinng | Bug |
WORDSNET-21893 | List labels are lost after DOCX to PDF conversion | Bug |
WORDSNET-24428 | NullReferenceException is thrown upon rendering document | Bug |
WORDSNET-24386 | Chinese justified text looks improperly after open/save document | Bug |
WORDSNET-24476 | Page number style is incorrect in PDF after comparing documents | Bug |
WORDSNET-24586 | Comment range is changed after comparing documents | Bug |
WORDSNET-24475 | NullReferenceException is thrown upon rendering document with chart | Bug |
WORDSNET-23907 | Table Alignment Issue in converting RTF files to PDF | Bug |
WORDSNET-24565 | Replaced shape is not catched by compare method | Bug |
WORDSNET-24431 | Watermark is displayed over the text | Bug |
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:
@property
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:
@property
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 = builder.paragraph_format.borders.top
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")
doc.save("output.docx")
Added public property PageSetup.Margins
Related issue: WORDSNET-23931
A new public property margins has been added to the PageSetup class:
@property
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