Aspose.Words for .NET 22.8 Release Notes

Major Features

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

  • AZW3 (also called KF8) file format is now supported for import and export.
  • Implemented support for cell spacing in tables upon rendering.
  • Improved font substitution for symbols.
  • Improved the rotation algorithm of axis labels of the charts.

Full List of Issues Covering all Changes in this Release (Reported by .NET Users)

KeySummaryCategory
WORDSNET-3895Support export to Kindle and Mobipocket formatsNew Feature
WORDSNET-14915Table width and alignment issuesNew Feature
WORDSNET-11557‘Allow Spacing between cells’ option of a Table is not preserved during rendringNew Feature
WORDSNET-7013Support  “Use Word 2003 indent rules for text next to wrapped objects” compatibility optionNew Feature
WORDSNET-23555Provide Aspose.Words for Python 3.10New Feature
WORDSNET-23839Export Phonetic Guide content to TXTNew Feature
WORDSNET-24104Inaccurate font fallback for chess pawn symbol when saving to PDFNew Feature
WORDSNET-23999Send warning about accessibility issues when saving to PDF/A and PDF/UAEnhancement
WORDSNET-24046Add an option to specify path where Aspose.Words should look for harfbuzz.dllEnhancement
WORDSNET-12694NumPages field returns incorrect valueEnhancement
WORDSNET-5256Part of content is moved to the previous page during renderingEnhancement
WORDSNET-9749Document.UpdateFields does not update the TOC field page numbersEnhancement
WORDSNET-20239LayoutCollector incorrectly returns page indexEnhancement
WORDSNET-22594508 /WCAG Compliance word documentEnhancement
WORDSNET-11815VML objects not supported during Html to Word conversionEnhancement
WORDSNET-24015Fix critical SonarQube issuesEnhancement
WORDSNET-18523Vertical spacing of some elements differ in PDFBug
WORDSNET-19953Table width is changed after DOCX to PDF conversionBug
WORDSNET-16089Table’s cell is disappeared after calling UpdateTableLayout in PDFBug
WORDSNET-12693Document.PageCount returns incorrect valueBug
WORDSNET-11372Text does not render correctly in output PDFBug
WORDSNET-11932DOCX to PDF conversion issue with table renderingBug
WORDSNET-3692Table width is incorrect during renderingBug
WORDSNET-1043Table layout is incorrectBug
WORDSNET-13120Vertical spacing of empty rows is reduced in PDFBug
WORDSNET-5143Spacing between lines is bigger after renderingBug
WORDSNET-5926Cellspacing not working for PDF while using similar code snippetBug
WORDSNET-7263Contents moved to previous page in output PDF fileBug
WORDSNET-5606Borders around table are lost during renderingBug
WORDSNET-7204AutoShape is not aligned with the Table in PDFBug
WORDSNET-7203Cell spacing between outer thick border and Table Cells is not preserved in PDFBug
WORDSNET-8101Spacing between Cells is not respected in fixed page formatsBug
WORDSNET-8304Cell spacing/Rendered Table column widths differ in PDFBug
WORDSNET-9368Page wraps at wrong place due to cell spacing in the tableBug
WORDSNET-8442Spacing between Cells is not respected in fixed page formatsBug
WORDSNET-9936Width of table’s cells is changed after conversion from DOCX to PDFBug
WORDSNET-10849Contents position is changed after conversion from DOC to PDFBug
WORDSNET-10958Table’s cell wrapping issue while converting HTML to PDFBug
WORDSNET-11192DOCX to PDF conversion issue with table’s cell spacingBug
WORDSNET-12070Spacing is lost after conversion from DOC to HTML/MHTML/SVG/ePubBug
WORDSNET-12053Cell spacing is lost after conversion from DOC to PDFBug
WORDSNET-12601Tables have incorrect widths in PDFBug
WORDSNET-12818Content moves to previous pages in PDFBug
WORDSNET-12703Table size reduced in PDF after Word to PDF conversionBug
WORDSNET-13317Spacing between table cells not always taken into account correctly during renderingBug
WORDSNET-13893Table cell spacing/wrapping incorrect during rendering to PDFBug
WORDSNET-13892Table borders lost during rendering to PDFBug
WORDSNET-13937Paragraph is rendered on previous page in output PDFBug
WORDSNET-13987A table row moves to the previous Page in PDFBug
WORDSNET-14446‘border-spacing’ value is ignored during conversion from HTML to PDFBug
WORDSNET-15071Allow spacing between cells is lost after DOTX to PDF conversionBug
WORDSNET-16414Table position and height is changed after conversion from DOCX to PDFBug
WORDSNET-16447A Paragraph renders at the end of previous page in PDFBug
WORDSNET-16562Table incorrect after convert to PDFBug
WORDSNET-16740Incorrect Table Layout in PDFBug
WORDSNET-17498Table cell content being wrapped up on generating PDFBug
WORDSNET-17807DOCX to PDF conversion issue with images positionBug
WORDSNET-18532Table borders missing when saving to PDFBug
WORDSNET-18539Document.PageCount returns incorrect valueBug
WORDSNET-21311DOCX to PDF conversion layout issueBug
WORDSNET-18594A paragraph moves to the end of previous page in PDFBug
WORDSNET-18601DOCX to PDF conversion issue with cell’s spacingBug
WORDSNET-18960PDF output different than MS Word PDF outputBug
WORDSNET-19119Text is shifted up to previous page in output PDFBug
WORDSNET-20161Page numbers in TOC are not updating correctlyBug
WORDSNET-21490Table Conversion Issue on docx to PDFBug
WORDSNET-22199Spacing between table cells are lost after DOCX to PDF conversionBug
WORDSNET-22430A Paragraph moves to previous page in PDFBug
WORDSNET-22912The table border displayed not correctly after converting from DOCX to PDFBug
WORDSNET-23666Spacing between cells is lost upon renderingBug
WORDSNET-23949Table layout is distorted after renderingBug
WORDSNET-14188Cell borders are missing for table in PDFBug
WORDSNET-16170The default table cell spacing ignoredBug
WORDSNET-17665The rendered output is missing one pageBug
WORDSNET-17808DOCX to PDF - table not sameBug
WORDSNET-21834Table is not rendered properly when exported to PDFBug
WORDSNET-4794Support cell spacing in layoutBug
WORDSNET-22774Table border issues when converting DOCXBug
WORDSNET-24099Consider providing an ability to get font of the current LayoutEnumerator entityBug
WORDSNET-7014Extra page is incorrectly printed at the end of first PageBug
WORDSNET-4106Custom table borders are changed during renderingBug
WORDSNET-24028FileCorruptedException is thrown upon loading RTF documentBug
WORDSNET-23619Intervals between words are too big in some cells in RTL tableBug
WORDSNET-24042PDF with tables is imported improperlyBug
WORDSNET-23247X-Axis labels are improperly rotatedBug
WORDSNET-23881InvalidOperationException is thrown upon updating fieldsBug
WORDSNET-24043RTL content is imported improperly from PDFBug
WORDSNET-19736Incorrect scaling of the vertical numeric axis when converting to PDFBug
WORDSNET-22866UWP application does not compile in release modeBug
WORDSNET-23183H3 tag doesnt support CSS classes when converted from HTML to WordBug
WORDSNET-24128InvalidOperationException on DOCX roundtripBug
WORDSNET-24049Cross references are not working after CXP updatesBug
WORDSNET-24101DOCX to RTF conversion errorBug
WORDSNET-19737Incorrect minimum of the vertical numeric axis when converting to PDFBug
WORDSNET-23814Text shaper factory failed to return text shaper exception on LinuxBug
WORDSNET-24053Style Separator is not inserted if add an empty section before building the documentBug
WORDSNET-23815Additional revision in the output documentBug
WORDSNET-23479Content overflows on next page after adding watermarkBug
WORDSNET-23494Order of paragraphs is changed after open save WML documentBug
WORDSNET-19738Axis labels text is rendered in two lines when converting to PDFBug
WORDSNET-23620Last symbols from first column are moved to the second column in RTL tableBug
WORDSNET-24018Revisions reports no groups while there is a gorupBug
WORDSNET-24087Bookmark itself is removed after setting it’s text to empty stringBug
WORDSNET-22737Image is lost after DOCX to PDF conversionBug
WORDSNET-24026VML WordArt’s width is incorrectBug
WORDSNET-23765Checkboxes are imported improperly from ODTBug
WORDSNET-23680REF field is lost after updating fields and saving document to Fixed Page formatsBug
WORDSNET-24044EQ field is exported incorrectly to TXTBug
WORDSNET-24051Hyphenated text is wrapped improperlyBug
WORDSNET-23935MS Word fails to load a DOCX document generated by Aspose.WordsBug
WORDSNET-24098The document appears to be corrupted - exception when trying to open DOCXBug
WORDSNET-23664Text in category labels is wrapped improperlyBug
WORDSNET-21063Preserve 5px outset red border around DIV during HTML to Word ConversionBug
WORDSNET-24064FileCorruptedException is thrown upon loading ODT documentBug
WORDSNET-23917InvalidOperationException at FootnoteCorrector.MergeLinesBug
WORDSNET-24086Bullet symbols are missing when saving to PDF with UseCoreFonts optionBug
WORDSNET-22792Paragraphs in wrong format in saved documentBug
WORDSNET-23891PdfRenderer should not reference internal libraries in release buildsBug
WORDSNET-24066Bullet symbols are missing when saving to PDF with UseCoreFonts optionBug
WORDSNET-23901StackOverflowException on MHTML loadingBug
WORDSNET-24031Incorrect RTL table and table content positioningBug
WORDSNET-23805FileCorruptedException is thrown upon loading MHTML documentBug
WORDSNET-19415List item’s indent is incorrect after DOCX-HTML-DOCX roundtripBug
WORDSNET-3626Border style of a table is missed during renderingBug
WORDSNET-22904Chinese document layout differs from MS WordBug
WORDSNET-22695The file is empty after load and save with words sdkBug
WORDSNET-24032Part of content is missed and text wrapping is changed after importing PDFBug

Full List of Issues Covering all Changes in this Release (Reported by Java Users)

KeySummaryCategory
WORDSNET-21008PDF is losing the table cell style after DOCX to PDF conversionBug
WORDSNET-15723Table border is lost after conversion from DOCX to PDFBug
WORDSNET-16850DOC to PDF Number of Pages DecreasedBug
WORDSNET-17448Table layout changes during PDF conversion for a Hebrew fileBug
WORDSNET-19219TOC page number issue after Section having Landscape orientation and Section breakBug
WORDSNET-21009Incorrect rendering of Table spanning across multiple TextColumnsBug
WORDSNET-21050Spacing between Table Cells not preserved during DOCX to PDF conversionBug
WORDSNET-23630Part of content is moved to previous pageBug
WORDSNET-23360DOCX to PDF: Table rendered incorrectlyBug
WORDSNET-24088InvalidOperationException when converting MHTML to DOCBug
WORDSNET-23705Row is moved to previous page upon renderingBug
WORDSNET-23975Font size is changed after rendering documentBug
WORDSNET-24106WordML to DOCX: Missing contentBug
WORDSNET-24052Line moved to the next pageBug
WORDSNET-23860NullReferenceException is thrown upon rendering documentBug
WORDSNET-23861Position of endnotes is incorrect after renderingBug

Public API and Backward Incompatible Changes

This section lists public API changes that were introduced in Aspose.Words 22.8. 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 support for AZW3 export

Related issue: WORDSNET-3895

Aspose.Words now can export documents to AZW3 file format.

AZW3 (also called KF8) is Amazon Kindle’s proprietary e-book file format. AZW3 is essentially a compiled EPUB.

The following publicly visible enum values were added:

FileFormat.Azw3
SaveFormat.Azw3

The use cases for saving a document to AZW3 file format are as follows:

Document doc = new Document("in.docx");
doc.Save("out.azw3");
or
Document doc = new Document("in.docx");
HtmlSaveOptions options = new HtmlSaveOptions(SaveFormat.Azw3);
doc.Save("out.azw3", options);

Added warnings for accessibility issues when saving to PDFA and PDFUA

Related issue: WORDSNET-23999

PDF/A and PDF/UA format imposes several accessibility requirements related to the document content that cannot be fulfilled during automatic conversion from a document in Word format to PDF. See documentation article for more info. Now warnings are issued for some of these problems. The warnings are issued when saving to one of the PDF/A or PDF/UA formats and the issue violates the compliance. E.g. the warning about missing document title will be issued when saving to PDF/UA and will not be issued when saving to PDF/A.

All warnings are of WarningType.MinorFormattingLoss and WarningSource.Pdf. Here is the list of new warnings Description values:

  • “Document title is missing. This violates the compliance requirements. The output document will not be fully compliant.”
  • “The document contains headings which levels are not consecutive. This violates the compliance requirements. The output document will not be fully compliant.”
  • “There are shapes without alt text in the document. This violates the compliance requirements. The output document will not be fully compliant.”
  • “There are tables without alt text in the document. This violates the compliance requirements. The output document will not be fully compliant.”
  • “There are hyperlinks without alt text in the document. This violates the compliance requirements. The output document will not be fully compliant.”
  • “There are tables without header row/column in the document. This violates the compliance requirements. The output document will not be fully compliant.”
  • “The document contains Unicode PUA characters. This violates the compliance requirements. The output document will not be fully compliant.”
  • “The document contains .notdef glyphs. This violates the compliance requirements. The output document will not be fully compliant.”

Removed obsolete property HtmlSaveOptions.ExportTextBoxAsSvg

Related issue: WORDSNET-23734

The obsolete property HtmlSaveOptions.ExportTextBoxAsSvg has been removed. Please use the HtmlSaveOptions.ExportShapesAsSvg property instead.