Aspose.Words for Java 17.1.0 Release Notes

Major Features

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

  • TxtSaveOptions.ForcePageBreaks public property
  • SaveOptions.MemoryOptimization public property
  • New public API class FrameFormat available in Paragraph.FrameFormat
  • Support for DOCX roundtrip of multiple MS Word 2013 native document options added
  • Supported DOCX roundtrip of Effect Container element 
  • DOCX Roundtrip of Extension lists suppororted for Charts and other graphics
  • Shape texture brush with EMF image rendering implemented
  • Shape positioning inside tables precision improved
  • Implemented support for ‘FitText’ attribute
  • Improved space shrink logic for Asian text
  • Improved Unicode normalization performance during layout
  • Improved handling of invalid hyphenation dictionaries
  • Improved handling of collapsed table rows
  • Improved extracting document outline when TOC headings contain hidden entries
  • Fixed positioning issue with Arabic list labels
  • Fixed height issue with LTR list labels in RTL paragraphs

Full List of Issues Covering all Changes in this Release

WORDSJAVA-1228Performance issue with updateFields method.Performance
WORDSNET-11066TOC is built incorrectlyBug
WORDSNET-11779/hidden cell break/ Docx to Pdf conversion issue with table borderBug
WORDSNET-11962/LTR font metrics for RTL paragraph list/ A paragraph incorrectly renders at the end of previous page in PDFBug
WORDSNET-12214/LTR font metrics for RTL paragraph list/ Extra page after DOCX to imageBug
WORDSNET-12234Document.AcceptAllRevisions incorrectly removes some text from documentBug
WORDSNET-12247/fitText + spacing/ Text in table cells is wrapped incorrectly after DOCX to PDFBug
WORDSNET-13860Html to Docx/Pdf conversion issue with table’s borderBug
WORDSNET-13928Shape in table is rendered improperly.Bug
WORDSNET-13966Cell’s width is lost after conversion from Docx to HtmlBug
WORDSNET-14058Docx to Pdf conversion issue with hidden shapeBug
WORDSNET-14157/LTR font metrics for RTL paragraph list/ Hebrew text is rendered on previous pages in output PdfBug
WORDSNET-14222/hidden field result/ Images are duplicated after conversion from html to JpegBug
WORDSNET-14302Incorrect font name in XE fieldBug
WORDSNET-14332Uppercase characters are converted to lowercase in output PdfBug
WORDSNET-14338Shape is rotated after conversion from Doc to PdfBug
WORDSNET-14341Image borders added in the PDF renditionBug
WORDSNET-14358/LTR font metrics for RTL paragraph list/ Same program with same aspose jar produces different outputs in different machinesBug
WORDSNET-14375LineStartArrow and LineEndArrow attributes are confused after DML->VML conversion.Bug
WORDSNET-14381List labels are changed after conversion from Doc to OdtBug
WORDSNET-14387Chart losts its content during open/save a docxBug
WORDSNET-14394Footnote numbers are wrapped incorrectly after conversion from Docx to PdfBug
WORDSNET-14401Radio buttons are not showing as ‘selected’ or ‘checked’ when converting to fixed htmlBug
WORDSNET-14429Document based on a template loses normal style after saving with Aspose.WordsBug
WORDSNET-14461/LTR font metrics for RTL paragraph list/ Text is rendered on previous page in output PdfBug
WORDSNET-14467Custom font formatting applied via Template gets lost in PDFBug
WORDSNET-14473Word to HTML: Issue with table border color outputBug
WORDSNET-14478Document.UpdateFields does not update REF fieldsBug
WORDSNET-14494Docx to Pdf conversion issue with Arabic list labelsBug
WORDSNET-14501Paragraph alignment in cells in a TFG data table is incorrectBug
WORDSNET-14502Docx to Pdf conversion issue with image renderingBug
WORDSNET-14509TOC not updating correctlyBug
WORDSNET-14514List Labels are incorrect after conversion from Docx to PdfBug
WORDSNET-14530Shape is rendered on previous page in output HtmlfixedBug
WORDSNET-14544Dml shape in TestJira14534 is rendered improperly.Bug
WORDSNET-14551Diagram embedded in a word document gets modified when transformed to PDFBug
WORDSNET-14556MailMerge.UseWholeParagraphAsRegion does not generate the correct result when its value is falseBug
WORDSNET-14566Text is disappeared in output PdfBug
WORDSNET-14567Doc to Pdf conversion issue with GroupShape renderingBug
WORDSNET-14568Incorrect text alignment in Cells in PDFBug
WORDSNET-14569Rendering of Lines at the end and last page are missing in PDFBug
WORDSNET-14572When DOCX is converted to PDF, some shapes go to wrong positions.Bug
WORDSNET-14591OutOfMemoryException is thrown while saving DocBug
WORDSNET-14592After Insert HTML to document, NullReferenceException occurs when saving.Bug
WORDSNET-14598Text color is changed after conversion from Docx to Doc/PdfBug
WORDSNET-14612Document with nested remarks is corrupted when savedBug
WORDSNET-14617/special hidden/ Listnum value is missingBug
WORDSNET-14629Doc to Pdf conversion issue with shape rendering in PdfBug
WORDSNET-14630Doc to Pdf conversion issue with image rendering in PdfBug
WORDSNET-14640System.ArgumentOutOfRangeException is thrown while saving document to PngBug
WORDSNET-14680OLE is changed to image after conversion from Doc to DocxBug
WORDSNET-14694MS Word opens the output Doc in “PROTECTED VIEW” after conversion from RtfBug
WORDSNET-6240Extra border lines appear while converting Word document to HTML and EPUB.Bug
WORDSNET-14092Document.Compare does not work correctly with tablesEnhancement
WORDSNET-14143Images are lost after re-saving mhtmlEnhancement
WORDSNET-14291The font of Chinese text is incorrect when Txt is imported into DOMEnhancement
WORDSNET-14336MhtmlReader does not support text parts without type.Enhancement
WORDSNET-14395High-level access to the fields in existing documentEnhancement
WORDSNET-14405Aspose.Words 16.10 creates only one page in text(txt) documentEnhancement
WORDSNET-14468Issue with SVG using Linq Reporting engineEnhancement
WORDSNET-14622Aspose.Words hangs during loading the RTFEnhancement
WORDSNET-6443Document.RemoveAllChildren doesn’t reduce the file sizeEnhancement
WORDSNET-13763Hyphenation.RegisterDictionary throws System.ArgumentExceptionException
WORDSNET-13847Aspose.Words.FileCorruptedException occurs upon loading a DOCException
WORDSNET-14483Document.AcceptAllRevisions throws System.NullReferenceExceptionException
WORDSNET-14497Aspose.Words.FileCorruptedException is thrown while loading OdtException
WORDSNET-14513Document.Save throws System.InvalidOperationExceptionException
WORDSNET-14541Aspose.Words.FileCorruptedException occurs upon loading a DOCXException
WORDSNET-14571Unable to save a Word document as a PDF - document has special number formattingException
WORDSNET-14643System.NullReferenceException is thrown while saving Docx to PdfException
WORDSNET-13482Add feature to insert online videoFeature
WORDSNET-13521Provide API to get position of FrameFeature
WORDSNET-14113Add feature to support Frames in Aspose.WordsFeature
WORDSNET-14558Loosing page number information while converting RTF to DOCXFeature
WORDSNET-14565Generate report from syntax like «[Person.Related.Car.Model]»Feature
WORDSNET-9992Add feature to remove embedded fonts from Word documentsFeature
WORDSNET-14351Loading and saving docx files in multi-threaded environment works extremely slowPerformance
WORDSNET-14450Hangs on exporting an MHTML document to PDF formatPerformance
WORDSNET-7959/slow/ Aspose.Words hangs during rendering DOCX to PDFPerformance
WORDSNET-7962Aspose.Words hangs on exporting huge encoded text documents to PDFPerformance

Public API and Backward Incompatible Changes

This section lists public API changes that were introduced in Aspose.Words 17.1.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.

SaveOptions.MemoryOptimization Property Added

When dealing with very large and complex documents Aspose.Words sometimes had problems during saving resulting in out of memory exceptions, disk swapping and generally failures.

We’ve introduced an option to optimize memory consumption during these scenarios. When set to true it will improve document memory footprint but will add extra time to processing. This optimization is only applied during save operation.

/// <summary>
/// Gets or sets value determining if memory optimization should be performed before saving the document.
/// Default value for this property is <b>false</b>.
/// </summary>
public boolean MemoryOptimization {get;set;}

Usage Example:

Document doc = new Document("myDoc.docx");
SaveOptions so = SaveOptions.createSaveOptions(SaveFormat.PDF);
so.setMemoryOptimization(true);"myFile.pdf", so);

Available to API users as Paragraph.FrameFormat. This class exposes all frame properties of paragraph in “readonly” mode

/// <summary>
/// Represents frame related formatting for a paragraph.
/// </summary>
/// <p>This object is always created. If a paragraph is a frame, then all properties will contain respective values, otherwise
/// all properties are set to their defaults.</p>
/// <p>Use <see cref="IsFrame" /> to check whether paragraph is a frame.</p>
public class FrameFormat

WORDSNET-14405 - TxtSaveOptions.ForcePageBreaks Property Added

New public property ForcePageBreaks is added into the TxtSaveOptions class:

/// <summary>
/// <para>Allows to specify whether the page breaks should be preserved during export.</para>
/// <para>The default value is <b>false</b>.</para>
/// </summary>
public boolean ForcePageBreaks { get; set; }

The property affects only page breaks that are inserted explicitly into a document. It is not related to page breaks that MS Word automatically inserts at the end of each page.


TxtSaveOptions saveOptions = new TxtSaveOptions();
saveOptions.setForcePageBreaks(true);, saveOptions);