Aspose.Words for Java 17.7 Release Notes

Major Features

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

• Performance of saving to PDF is improved.
• The proper algorithm for rendering of shapes with automatic size textboxes (i.e. closest to MS Word output) implemented.
• The rendered PDF documents can now show the document title in the title bar of the viewer. This is controlled by “PdfSaveOptions.DisplayDocTitle” property.
• Improved font rendering in PDF documents for Adobe Illustrator limitations.
• Improved rendering of fonts with simulated bold style.
• Vertical text rendering in DrawingML textboxes improved.
• Problem with rendering of numbers on horizontal axis in DrawingML Charts fixed.
• Implemented support for “Wrap trailing spaces to next line” option.
• Implemented support for footnote continuation notices.
• Improved text wrapping logic for “2013 and later” documents.
• Improved non-breaking space width calculation.
• Improved Asian text justification logic.

Full List of Issues Covering all Changes in this Release

Public API and Backward Incompatble Changes

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

WORDSNET-14190 - Make the Title of the Generated Documents show up in Title Bar

New property DisplayDocTitle was added to PdfSaveOptions to control behavior of how document’s title is presented in output PDF document:

/// <summary>
/// A flag specifying whether the window’s title bar should display the document title taken from
/// the Title entry of the document information dictionary.
/// </summary>
/// <remarks>
/// If <c>false</c>, the title bar should instead display the name
/// of the PDF file containing the document.
///
/// <para>The default value is <c>false</c>.</para>
/// </remarks>
public boolean getDisplayDocTitle()
public void setDisplayDocTitle(boolean value)

WORDSNET-15504 -  Shape AspectRatioLocked Default Value was Changed for Shapes Inserted through the DocumentBuilder.insertImage Method.

Shape AspectRatioLocked default value was changed for shapes inserted through the DocumentBuilder.insertImage method. Now, to mimic MS Word behavior this value is “true” for ShapeType.Image upon inserting image through the DocumentBuilder or through the Model.

/// <summary>
/// Specifies whether the shape's aspect ratio is locked.
/// </summary>
/// <remarks>
/// <p>The default value depends on the <see cref="ShapeType"/>, for the ShapeType.Image it is <b>true</b>
/// but for the other shape types it is <b>false</b>.</p>
/// <p>Has effect for top level shapes only.</p>
/// </remarks>
public boolean getAspectRatioLocked()
public void setAspectRatioLocked(boolean value)

WORDSNET-14504 and WORDSNET-14803 - Changed Importing Behavior of Lists

Previously, list definitions were copied with a new identifier while importing. Now Aspose.Words reuses identical list definitions in the destination. Equality of list definitions in the source and destination is determined by their identifiers. Also Aspose.Words preserves list definition identifiers from the source when equal list definition cannot be found in the destination. This is how MS Word behaves.