Aspose.Words for Java 22.12 Release Notes

Major Features

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

  • Update links in Java ApiReferences
  • Support Ripemd160 digital sign for PDF documents
  • Implemented an abbility to specify the particular Margin type for the given section.
  • The new public properties ThemeColor and TintAndShade were introduced.
  • Implemented rendering of the linear trendline formula for DrawingML charts rendering.
  • Implemented optimization that significantly reduces the depth of graphics state nesting when rendering to PDF to maintain specification compliance.

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

WORDSJAVA-2799Update links in Java ApiReferencesNew Feature
WORDSJAVA-2710IllegalStateException is thrown when use substring in LINQ syntaxBug
WORDSJAVA-2704Support Ripemd160 digital sign for PDF documentsBug
WORDSJAVA-2795StringIndexOutOfBoundsException is thrown upon saving to PDFBug
WORDSNET-24363Phonetic Guide is not exported to TXTBug
WORDSNET-24634Aspose.Words selects wrong font upon renderinngBug
WORDSNET-21893List labels are lost after DOCX to PDF conversionBug
WORDSNET-24428NullReferenceException is thrown upon rendering documentBug
WORDSNET-24386Chinese justified text looks improperly after open/save documentBug
WORDSNET-24476Page number style is incorrect in PDF after comparing documentsBug
WORDSNET-24586Comment range is changed after comparing documentsBug
WORDSNET-24475NullReferenceException is thrown upon rendering document with chartBug
WORDSNET-23907Table Alignment Issue in converting RTF files to PDFBug
WORDSNET-24565Replaced shape is not catched by compare methodBug
WORDSNET-24431Watermark is displayed over the textBug

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

WORDSNET-14305RTF To PDF conversion issue with cell’s text renderingNew Feature
WORDSNET-23931Parameterized Margins property in PageSetupNew Feature
WORDSNET-10449DOC to PDF conversion issue with content positionNew Feature
WORDSNET-19791Imitate MS Word behavior when field update in header/footer affects container table height or widthNew Feature
WORDSNET-23681Word to PDF conversion - equation is mssing from the chartNew Feature
WORDSNET-24441Consider implementation of Border.ThemeColorNew Feature
WORDSNET-23747Table left indent in AW model does not match MS Word UI for an xml documentEnhancement
WORDSNET-24620Some font names in Noto fallback settings are outdatedEnhancement
WORDSNET-24402Differences in comparisonEnhancement
WORDSNET-24549ArgumentOutOfRangeException is thrown upon using ExtractPages methodBug
WORDSNET-24305Third level numbering is not preserved after appending documentBug
WORDSNET-24537DOCX to PDF: Wrong character positioningBug
WORDSNET-24293DOCX to PDF: Character orientation does not retain upon conversionBug
WORDSNET-24373“No table of figures entries found” is shown after updating fields in the documentBug
WORDSNET-24280Page numbers in TOC are incorrect after renderingBug
WORDSNET-19585Incorrect bottom-margin relative shape position in headerBug
WORDSNET-24112The table borders are not preserved during DOCX-HTML-DOCX roundtripBug
WORDSNET-23200EML to PDF conversion: validation fails: Maximum depth of graphics state nesting by q and Q operators exceededBug
WORDSNET-24630InvalidOperationException: Target width and heightBug
WORDSNET-24545ArgumentOutOfRangeException: Specified argument was out of the range of valid valuesBug
WORDSNET-24533NullReferenceException in GetForm()Bug
WORDSNET-24631InvalidOperationException: Incorrect CropBoxBug
WORDSNET-24609Unknown format on loading TXT fileBug
WORDSNET-24603“Unsupported file format: Unknown” on loading TXT fileBug
WORDSNET-22858Shape is converted from DML to VML while exporting document to DOCXBug
WORDSNET-24338Aspose.Words hangs upon updating fieldsBug
WORDSNET-24336NullReferenceException is thrown upon calling UpdateFieldsBug
WORDSNET-24546NullReferenceException when converting DOCX to PDFBug
WORDSNET-24513Bookmarks with duplicated names are lost in building bolocksBug
WORDSNET-24464Incorrect graphics in converted DOCX fileBug
WORDSNET-24466Footnote text is partially missingBug
WORDSNET-24443Revisions are rendered improperlyBug
WORDSNET-24224InvalidOperationException is thrown upon comparing documentBug
WORDSNET-24585Wrong export of hidden text into MarkdownBug
WORDSNET-24583SDT placeholder text is visible after rendering documentBug
WORDSNET-24529Hidden SDT becomes visible after open/save documentBug
WORDSNET-24519Text color in chart legend is changed after renderingBug
WORDSNET-24596Document.UpdateFields does not update RD fieldBug
WORDSNET-24579FileCorruptedException is thrown upon loading DOCX documentBug
WORDSNET-19866TOC color changes to blue when converting Word to HTMLBug
WORDSNET-24538ArgumentException is thrown upon updating fieldsBug
WORDSNET-24510Ideographic text inside list label is incorrectly rotated in vertical directionBug
WORDSNET-24570NullReferenceException is thrown upon rendering documentBug
WORDSNET-17524Document.UpdateFields method does not update page numbers of XE entries in INDEX fieldBug
WORDSNET-24591Chinese character are invisible after renderingBug
WORDSNET-24567Document compare throws System.InvalidOperationExceptionBug
WORDSNET-24170The name of group slice of PieOfPie chart is not rendered after converting to PDFBug
WORDSNET-24130Incorrect calculation of the chart space rectangle if manual layout is setBug
WORDSNET-24506Font of TOC entries changes after DOCX to PDF conversionBug
WORDSNET-24468Exception on loading text fileBug
WORDSNET-16405Document.Compare does not mimic MS Word behaviorBug
WORDSNET-16874The compared output contains improper table revisionsBug
WORDSNET-24312DOCX to HTML: InvalidOperationExceptionBug
WORDSNET-24151An error occurs when trying to save a document to EPUB with default optionsBug
WORDSNET-24571Part of table is moved to previous page upon renderingBug
WORDSNET-22225Performance issue during comparing Text filesBug
WORDSNET-24313FileFormatDetector doesn’t recognize PDF files with garbage at the beginningBug
WORDSNET-24551Aspose.Words.Shaping.HarfBuzz does not have a strong nameBug
WORDSNET-24511Redundant whitespace is added to the field value after updateBug
WORDSNET-24536FileCorruptedException is thrown upon loading DOCX documentBug
WORDSNET-24542Symbols are rendered as tofuBug
WORDSNET-24297DOC to PDF: Overlapping imagesBug
WORDSNET-24247Section Header becomes text-wrapped around iconsBug

Public API and Backward Incompatible Changes

This section lists public API changes that were introduced in Aspose.Words 22.12. 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 new public properties ThemeColor and TintAndShade

Related issue: WORDSNET-24441

A new public property ThemeColor has been added to class Border:

/// <summary>
/// Gets or sets the theme color in the applied color scheme that is associated with this Border object.
/// </summary>
public ThemeColor ThemeColor { get; set; }

A new public property TintAndShade has been added to class Border:

/// <summary>
/// Gets or sets a double value that lightens or darkens a color.
/// </summary>
public double TintAndShade { get; set; }

Use Case: Explains how to work with ThemeColor and TintAndShade.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Border topBorder = builder.ParagraphFormat.Borders.Top;
topBorder.LineWidth = 0.5;
// Sets the value of ThemeColor.
topBorder.ThemeColor = ThemeColor.Accent1;

Border bottomBorder = builder.ParagraphFormat.Borders.Bottom;
bottomBorder.LineWidth = 0.5;
// Sets the value of ThemeColor.
bottomBorder.ThemeColor = ThemeColor.Accent2;

Border leftBorder = builder.ParagraphFormat.Borders.Left;
leftBorder.LineWidth = 1.5;
// Sets the value of ThemeColor.
leftBorder.ThemeColor = ThemeColor.Accent3;
// Sets the lightens value.
leftBorder.TintAndShade = 0.25;

Border rightBorder = builder.ParagraphFormat.Borders.Right;
rightBorder.LineWidth = 1.5;
// Sets the value of ThemeColor.
rightBorder.ThemeColor = ThemeColor.Accent4;
// Sets the darkens value.
rightBorder.TintAndShade = -0.125;

builder.Write("Lorem Ipsum");

Added public property PageSetup.Margins

Related issue: WORDSNET-23931

A new public property Margins has been added to the PageSetup class:

/// <summary>
/// Returns or sets preset <see cref="Aspose.Words.Margins"/> of the page.
/// </summary>
public Margins Margins { get; set; }

A new public enum Margins has been introduced:

/// <summary>
/// Specifies preset margins.
/// </summary>
public enum Margins

Use Case: Explains how to get and set the specified Margin type for the given section.

Document doc = new Document("in.docx");
// Getting the current Margin type.
if (doc.Sections[1].PageSetup.Margins == Margins.Normal)
    // Setting the specified Margin type.
    doc.Sections[1].PageSetup.Margins = Margins.Mirrored;