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

WORDSJAVA-1525Symbol Character are broken when rendering over LinuxBug
WORDSJAVA-1527DOCX to PDF conversion issue with shape’s text when it is opened in Adobe Illustrator CC 2017Bug
WORDSJAVA-1532Superscript and subscript are lost in output HTML and PDFBug
WORDSJAVA-1547Document.Compare generates extra revisionsBug
WORDSJAVA-1553Problem converting Word with Math to PDF over Mac and Linux (Ubuntu 12.04)Bug
WORDSJAVA-1556Number list of RTF file removes in conversionBug
WORDSJAVA-1595Proper printing of NaN in SVG path.Bug
WORDSJAVA-814Check Aspose.Words for Java with Maven local repositoryEnhancement
WORDSJAVA-1508Metered License does not workException
WORDSJAVA-1528DOC to PDF conversion throws RuntimeExceptionException
WORDSJAVA-1539Aspose.Words.FileCorruptedException is thrown while loading DOCException
WORDSJAVA-1571FileCorruptedException occurs when specifying Locale before creating a Document objectException
WORDSJAVA-1606Compare documents returns an IllegalStateException when document contains contains private use Unicode charactersException
WORDSJAVA-1598Make “WindowsNativeCall_x86x64.dll” independent from Visual C++ Redistributable Packages
WORDSJAVA-1509DOCX to PDF Conversion gradually slowing down & Aspose Word Save taking long timePerformance
WORDSJAVA-1565Performance difference in 16.7 and 17.5Performance
WORDSJAVA-1607Multithreading broken in Aspose.Word for Java 17.6Regression
WORDSNET-10407A Table is moved from middle of page to the top in PDFBug
WORDSNET-10598/table grid/ Table’s layout get corrupted after conversion from Docx to PdfBug
WORDSNET-10963Table’s position is changed after conversion from Docx to PdfBug
WORDSNET-10964Docx to Pdf conversion issue with shape positionBug
WORDSNET-11256Textboxes partially render beyond right edge of page in PDFBug
WORDSNET-11611/wrap trailing spaces to next line compat option/ Spaces from the start of second line of Paragraph are lost in PDFBug
WORDSNET-12651/footnotes + continuation notice/Text flows to the previous page (Doc to Pdf conversion)Bug
WORDSNET-13989GroupShape does not render correctly in PdfBug
WORDSNET-14239Document.Compare generates extra revisionsBug
WORDSNET-14631Doc to Pdf conversion issue with GroupShapeBug
WORDSNET-14797Compare works incorrectly since 16.10 versionBug
WORDSNET-14844/footnotes+continuation notice/Docx to fixed page format conversion issue with text positionBug
WORDSNET-14876Issue with HTML to Word Conversion - Textarea BorderBug
WORDSNET-14930Number index in Word gets changed after converting from html (DOCX-HTML-DOCX roundtrip)Bug
WORDSNET-15045/footnotes+continuation notice/Page is broken incorrectly if last paragraph on page is divided on two pagesBug
WORDSNET-15100Aspose.Words incorrectly works with font family lists in HTML import.Bug
WORDSNET-15241Document.Compare generates unnecessary delete and insert revisions for tableBug
WORDSNET-15251GetChildNodes returns extra nodesBug
WORDSNET-15281Superscript and subscript are lost in output HTML and PDFBug
WORDSNET-15305Table cell RTL text alignment issueBug
WORDSNET-15308Docx to Pdf conversion issue with image’s renderingBug
WORDSNET-15313Table text is splitting into two linesBug
WORDSNET-15330Document.Compare generates extra revisionsBug
WORDSNET-15349Shape is flipped after conversion from Docx to PdfBug
WORDSNET-15362/text wrap/ Formatting issue with floating paragraphBug
WORDSNET-15369/wrap trailing spaces/ Some lines are pushed from page bottom to next page in resultant PDFBug
WORDSNET-15404Document.UpdateFields does not update the formula fieldBug
WORDSNET-15405System.InvalidCastException is thrown while saving DOCX to PDFBug
WORDSNET-15413Scale of charts is changed in resultant PDFBug
WORDSNET-15421Sub-divisions appear on the x-axis in resultant PNGBug
WORDSNET-15423DocumentBuilder.Write writes the text with incorrect font after moving the cursor to bookmarkBug
WORDSNET-15426DOCX to ODT conversion issue with shape’s gradient fill colorBug
WORDSNET-15436Symbols are changed after conversion from DOCX to PDFBug
WORDSNET-15443Rendering issue of Vertical text of SmartArtBug
WORDSNET-15444DOCX to HTML conversion generates blank imagesBug
WORDSNET-15455Number index in Word gets changed after converting from html (DOCX-HTML-DOCX roundtrip)Bug
WORDSNET-15460Chart’s X-Axis is not rendered correctly in output PDFBug
WORDSNET-15461Chart’s plot area is not rendered correctly in output PDFBug
WORDSNET-15464Docx to PDF conversion issue with text alignmentBug
WORDSNET-15470Mirror Margin issue in DOCX to PDF renderingBug
WORDSNET-15477Names of MatchCase and FindWholeWordsOnly properties in FindReplaceOptions looks incorrectBug
WORDSNET-15480Spaces between words lost in rendered ImageBug
WORDSNET-15487Shape’s position and size is changed in output PDFBug
WORDSNET-15488Docx to PDF conversion issue with shape’s renderingBug
WORDSNET-15489Docx to PDF conversion issue with shape’s renderingBug
WORDSNET-15492Shape’s text is not rendered in output PDFBug
WORDSNET-15493DOCX to PDF conversion issue with Shape’s renderingBug
WORDSNET-15494Text of shape is truncated in output PDFBug
WORDSNET-15495Text of shape is truncated in output PDFBug
WORDSNET-15502Corrupt output DOCX when using Aspose to save MS Word document containing SmartArtBug
WORDSNET-15504Default value of Shape.AspectRatioLocked is incorrectBug
WORDSNET-15534Chart’s X and Y axis are changed in output PDFBug
WORDSNET-15537Compare documents returns an ‘System.InvalidOperationException’ when document contains contains private use Unicode charactersBug
WORDSNET-15543Incorrect shape size when margins are wider than width in shape propertiesBug
WORDSNET-15546DOC to PDF produces output with disturbed formatting.Bug
WORDSNET-5279/footnotes+continuation notice/Some endnotes are moved to previous pageBug
WORDSNET-5581TextBox content layout is shifted.Bug
WORDSNET-8940/table grid/ Text renders outside the right page edge in PDFBug
WORDSNET-14801A Picture moves towards the top page edge in PDFEnhancement
WORDSNET-15262DOCX to PDF conversion issue with shape’s text when it is opened in Adobe Illustrator CC 2017Enhancement
WORDSNET-15416Improve comparison of language attributesEnhancement
WORDSNET-15428Improve cell formatting comparison. #2Enhancement
WORDSNET-15447Improve row comparsion. #3Enhancement
WORDSNET-15544Incorrect oval shape width/height for shape with word wrap off, auto-fit onEnhancement
WORDSNET-14410Aspose.Words.FileCorruptedException is thrown while loading RTFException
WORDSNET-14683Aspose.Words.FileCorruptedException occurs upon loading a MHTException
WORDSNET-15103InvalidOperationException occured while re-saving RTF to DOCException
WORDSNET-15263DOC to PDF conversion throws InvalidOperationExceptionException
WORDSNET-15466Document.GetPageInfo throws exception “This operation requires the node to be inside the main document”Exception
WORDSNET-15468Document.GetPageInfo throws exception “This operation requires the node to be inside the main document”Exception
WORDSNET-15498GetStartPageIndex method of LayoutCollector throws NullReferenceExceptionException
WORDSNET-15499DOCX conversion is throwing IOExceptionException
WORDSNET-15513Aspose.Words.FileCorruptedException occurs upone loading a DOCXException
WORDSNET-15522Conversion RTF to PDF failing during the source file loading.Exception
WORDSNET-13968Export “border” attribute in output HtmlFeature
WORDSNET-14186Write revisions for MathML objects in HTML Export for HtmlOfficeMathOutputMode.MathML modeFeature
WORDSNET-14190Make the title of the generated documents show up in title bar , when opened in Acrobat readerFeature
WORDSNET-14290Support Structured Document Tag edit revisions (customXmlDelRangeStart/customXmlDelRangeEnd)Feature
WORDSNET-14539Provide separate method to remove unused styles onlyFeature
WORDSNET-15144Obtain correct horizontal alignment of imageFeature
WORDSNET-15296Support AUTOTEXT and GLOSSARY fieldsFeature
WORDSNET-1814Preserve cross-references during converting to HTMLFeature
WORDSNET-14223Hangs on loading the MHTML documentPerformance
WORDSNET-15435Shape rendering issue in resultant PDFRegression
WORDSNET-15514Exception on SetLicence with the 17.6 version on Mono over LinuxRegression
WORDSNET-15528Numeric format is broken after performing mail mergeRegression
WORDSNET-15529Exception using Reflection in 17.6Regression

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.