Aspose.Words for .NET 16.3.0 Release Notes

Major Features

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

  • Further improvements to the speed and public API for plain text extraction.
  • Render OfficeMath formulas to images separately from the document.
  • Shape and OfficeMath can now be saved to SVG.
  • Support for RC4 encryption.

Full List of Issues Covering all Changes in this Release

Key Summary Category
WORDSNET-10709 /asian typography detection/ Chinese wraps to the next line when English and Chinese characters combined in one paragraph Bug
WORDSNET-10710 /asian typography detection/ A line starts with a punctuation mark in PDF Bug
WORDSNET-12471 Shape.TextBox doesn’t keep its internal margins on save Bug
WORDSNET-12475 Alternate row background color (shading) is not correct in PDF Bug
WORDSNET-12775 Incorrect shadings applied in rendered PDF Bug
WORDSNET-12794 Table moves to left in generated PDF Bug
WORDSNET-12807 Large comment text truncated. SaveAs PDF with MS Word shows more data Bug
WORDSNET-12917 Removing content from Cell changes Font Bug
WORDSNET-12962 /strike through shape anchor/ MS Word to PDF: Extra line is added to the bottom of the image Bug
WORDSNET-12986 Docx to Pdf conversion issue with Shape rendering Bug
WORDSNET-12998 Document.UpdateFields does not update Section field Bug
WORDSNET-13004 Docx to Pdf Conversion modifies Hyperlinks with the Local Path of Docx Bug
WORDSNET-13006 /tab stops/ Text alignment is lost after DOCM to PDF Bug
WORDSNET-13013 /asian typography detection/ Docx to Pdf conversion issue with Chinese text rendering Bug
WORDSNET-13055 Text shape is transformed to text box or frame Bug
WORDSNET-13091 Text boxes positions are changed after re-saving Docx Bug
WORDSNET-13092 Image in content control is not rendered in output Doc/Pdf Bug
WORDSNET-13118 Repeating section content control displays wrong data in PDF Bug
WORDSNET-13141 Document.UpdateFields does not update REF field. Bug
WORDSNET-13146 RTF to Pdf conversion issue with PdfImageCompression.Jpeg Bug
WORDSNET-13158 Rotated text box (inside GroupShape) are not rotated when saved to PDF Bug
WORDSNET-13180 One Row Tables within a SDT are ignored Bug
WORDSNET-13191 Aspose.Words reads MHTML as a text file Bug
WORDSNET-13200 Document.UpdateFields lose the bold formatting of Ref fields Bug
WORDSNET-13209 Shape’s text color is changed from white to black in output Pdf Bug
WORDSNET-13210 Unexpected page breaks appear in output Pdf Bug
WORDSNET-13223 Aspose Words Document save to PDF distorts inserted Shape Bug
WORDSNET-13238 Mergefield TableStart inside an IF field are processed although the IF condition is false Bug
WORDSNET-13241 Contents are lost after saving Rtf to Docx Bug
WORDSNET-13242 Aspose.Words.Document hangs while loading Odt Bug
WORDSNET-13246 Replacement of URL (UNC) is losing \ and breaking links (FieldHyperlink.Address) Bug
WORDSNET-13247 FieldHyperlink.Address ignores slashes ("") while replacing hyperlinks Bug
WORDSNET-13248 The space between the bullet and starting text is not uniform Bug
WORDSNET-13257 Rtf to Docx conversion issue with table’s border Bug
WORDSNET-13259 Chinese text is wrapped incorrectly Bug
WORDSNET-13263 Quote fields in the header of Pdf are rendered incorrectly Bug
WORDSNET-13266 Some Paragraphs have more left indentation during importing MHT Bug
WORDSNET-13268 Creating TOC for text with non-BodyText OutlineLevel works unexpected Bug
WORDSNET-13276 SVG image is rendered as a blank picture while importing HTML document Bug
WORDSNET-13285 X-Axis labels are wrapped up into 2 lines in output Doc/Pdf Bug
WORDSNET-2159 “NullReferenceException” occurs when move to Header/Footer after linking header to previous. Bug
WORDSNET-6882 Investigate Run properties Bug
WORDSNET-10722 The document is encrypted using the RC4 CryptoAPI Encryption and this not currently supported. Enhancement
WORDSNET-11086 DOCX to HTML margin issue with paragraphs that have hanging indent Enhancement
WORDSNET-11608 Implement rendering Dml shadow effect for semi transparent and transparent areas. Enhancement
WORDSNET-12105 Take ‘display’ style into account when importing HTML elements Enhancement
WORDSNET-12219 Counter-increment is not producing the expected output Enhancement
WORDSNET-12221 InsertOleObject does not insert default icon and name for html file Enhancement
WORDSNET-12269 Render square shapes with texture as images to preserve the texture source format. // Losing signature quality when converting word to tiff Enhancement
WORDSNET-12449 Document.Save removes target="_blank" when saved to HtmlFixed Enhancement
WORDSNET-12511 Author property returns incorrect text Enhancement
WORDSNET-12627 Incorrect border of a horizontally merged cell Enhancement
WORDSNET-12824 Shape.TextBox report incorrect margin for a DML shape Enhancement
WORDSNET-13102 Shapes become invisible after saving Rtf to Doc/Docx/Pdf Enhancement
WORDSNET-13227 Implement rendering Dml inner shadow effect for semi transparent and transparent areas. Enhancement
WORDSNET-13312 REF fields are still being looked up from our IMailMergeDataSource Enhancement
WORDSNET-4107 WMF images are displayed incorrectly after converting to DOC/DOCX Enhancement
WORDSNET-10711 Aspose.Words.UnsupportedFileFormatException is thrown while loading document Exception
WORDSNET-12801 Aspose.Words.UnsupportedFileFormatException is thrown while loading Doc Exception
WORDSNET-12951 Aspose.Words.FileCorruptedException is thrown while loading Dot Exception
WORDSNET-13036 System.Security.Cryptography.CryptographicException occurs when trying to sign document with pfx certificate Exception
WORDSNET-13107 Aspose.Words.FileCorruptedException is thrown while loading Docx Exception
WORDSNET-13114 Nested IF statements cause error when merge field contains trailing backslash Exception
WORDSNET-13183 System.ArgumentOutOfRangeException occurs during rendering to PDF Exception
WORDSNET-13186 IllegalStateException: This operation requires the node to be inside the main document Exception
WORDSNET-13214 Aspose.Words.FileCorruptedException is thrown while loading html Exception
WORDSNET-13231 Document.Save throws System.IndexOutOfRangeException Exception
WORDSNET-13237 System.InvalidOperationException is thrown while saving Docx to Pdf. Exception
WORDSNET-13244 MailMerge.GetRegionsHierarchy throws System.InvalidCastException Exception
WORDSNET-13253 Aspose.Words.FileCorruptedException is thrown while loading Docx. Exception
WORDSNET-13274 System.InvalidOperationException occurs when saving DOCX to PDF Exception
WORDSNET-13283 Aspose.Words throws exception when updating fields Exception
WORDSNET-13287 Aspose.Words.FileCorruptedException is thrown while loading Doc Exception
WORDSNET-13288 Aspose.Words.FileCorruptedException is thrown while loading Doc Exception
WORDSNET-11774 Provide API to convert OfficeMath node to pictures (SVG, Raster images) Feature
WORDSNET-11865 Support Shape.Title property Feature
WORDSNET-12330 Provide API to convert Shape and OfficeMath nodes SVG Feature
WORDSNET-12857 Provide way to get FolderPath for SystemFontSource Feature
WORDSNET-12866 Provide API to set the Aspect Ratio to Scale Feature
WORDSNET-12942 Support RC4 CryptoAPI encryption Feature
WORDSNET-12965 Support of RC4 encrypted documents created by MS Word 2007/2010/2013 Feature
WORDSNET-13228 Implement rendering Dml glow effect for semi transparent and transparent areas. Feature
WORDSNET-13229 Implement rendering Dml soft edge effect for semi transparent and transparent areas. Feature
WORDSNET-5482 Support RC4 CryptoAPI encryption algorithm. Feature
WORDSNET-13178 Aspose.Words.Document constructor is very slow on the first call Performance
WORDSNET-13255 Infinite Loop when loading HTML with a specific SVG into Aspose.Words Performance
WORDSNET-12611 Cells width are not correct in output Docx/Pdf Regression

Public API and Backward Incompatible Changes

This section lists public API changes that were introduced in Aspose.Words 16.3.0. 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 a regression and modifies existing behavior is especially important and is documented here.

Renamed GetOpaqueRectangleInPixels to GetOpaqueBoundsInPixels in NodeRendererBase

WORDSNET-13230 (Tidy up NodeRendererBase class) has been resolved. We renamed GetOpaqueRectangleInPixels to GetOpaqueBoundsInPixels for names consistency and introduced GetBoundsInPixels method for consistency with other properties.

Reworked public API for PlainTextDocument creation (WORDSNET-13321)

Breaking API changes:

  • All public overloads of static Document.ExtractText methods removed
  • PlaintextDocument class renamed to PlainTextDocument
  • Added 4 public constructors to the PlainTextDocument class with signatures corresponding to the removed static Document.ExtractText methods

Shape and OfficeMath nodes can be saved as SVG

WORDSNET-12330 - (Provide API to convert Shape and OfficeMath nodes SVG) has been resolved.

Starting from 16.3.0 version it is possible to render OfficeMath formulas to image separately from whole document:

Document doc = new Document(@"C:\Temp\in.docx");
OfficeMath math = (OfficeMath)doc.GetChild(NodeType.OfficeMath, 0, true);
math.GetMathRenderer().Save(@"C:\Temp\formula.png", new ImageSaveOptions(SaveFormat.Png));

Also, now it is possible to pass SaveFormat.Svg into ImageSaveOptions, so OfficeMath and Shape nodes now can be save to SVG.

WORDSNET-12866 - Added feature to get-set AspectRatioLocked property of Shape.

Starting from 16.3.0 Version, Aspose.Words supports AspectRatioLocked property of Shape.


Shape shape = (Shape)doc.GetChild(NodeType.Shape, 0, true);

// Get/set AspectRatioLocked.
shape.AspectRatioLocked = true;

Plase none:  it is possible to get/set AspectRatioLocked for child shapes (mimic MS Word behavior), but AspectRatioLocked has effect only for top level shapes!

WORDSNET-13146 - Improvement of transparent image rendering to PDFA-1

PDF/A-1 specification prohibits transparency. In order to provide better output AW blends transparent images with white background. Previously images were blended only with PdfImageCompression.Auto. With PdfImageCompression.Jpeg transparent images were rendered by simply stripping alpha channel. Now images are blended for both PdfImageCompression.Auto and PdfImageCompression.Jpeg.