Browse our Products

Aspose.Words for Java 26.3 Release Notes

Major Features

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

  • AI Integration: Added the ability to create an instance of the OpenAiModel class directly.
  • Document Optimization: Extended the functionality of the JoinRunsWithSameFormatting method for more comprehensive content merging.
  • Rendering and Fonts: Improved the MS Office font fallback table for the CJK Unified Ideographs Extension G range.

Full List of Issues Covering all Changes in this Release

Expand to view the full list of issues, reported by Java Users.
KeySummaryCategory
WORDSJAVA-3308Fix Perfomance and Memory Issue with TabCountBug
WORDSJAVA-3305NullPointerException upon rendering document with Aptos fontBug
WORDSJAVA-3289Aspose.Words for Java 26.1 TextShaper produces OOM in Docker containerBug
Expand to view the full list of issues, reported by .NET Users.
KeySummaryCategory
WORDSNET-28900Allow to create instance of OpenAiModel class directlyNew Feature
WORDSNET-24822Support MSO properties during import tabsNew Feature
WORDSNET-28955MathML: mmultiscripts is incorrectly importedBug
WORDSNET-29085Incorrect rendering of SVG when the gradient is specified with ‘objectBoundingBox’ and exceeds the path boundsBug
WORDSNET-29084PDF to Word font substitution warning about Fanwood fontBug
WORDSNET-29083InvalidOperationException is thrown upon saving document as DOCXBug
WORDSNET-29079SVG gradient in userSpaceOnUse coordinates is rendered incorrectlyBug
WORDSNET-29077Unexpected DocumentBuilder behavior when moving inside SDTBug
WORDSNET-29070Import of MsoHtml lists differs from MS Word’s resultBug
WORDSNET-29066List items are imported from MsoHtml as normal paragraphsBug
WORDSNET-29054DOCX to PDF: Headers and footers disappear after section breakBug
WORDSNET-29052FileCorruptedException is thrown upon loading ‘.wml’ documentBug
WORDSNET-29050ArgumentOutOfRangeException is thrown upon using AutoFitBehavior.AutoFitToWindowBug
WORDSNET-29048SVG color gradients are corrupted when exporting to DOCBug
WORDSNET-29047SVG color gradients are corrupted when exporting to PDFBug
WORDSNET-29046Compare result does not match MS WordBug
WORDSNET-29044NullReferenceException is thrown upon building document layoutBug
WORDSNET-29041Layout issue when converting DOCX to PDFBug
WORDSNET-29040RTF to PDF: Converting the file raises an exceptionBug
WORDSNET-29033Chinese character is rendered as missed characterBug
WORDSNET-29000TOC is split into two parts in the document structureBug
WORDSNET-28999Gradient is lost after rendering SVGBug
WORDSNET-28996Metafile is rendered incorrectly in Vector modeBug
WORDSNET-28982IndexOutOfRangeException is thrown upon building document layoutBug
WORDSNET-28937Numbering is changed after exporting to HTMLBug
WORDSNET-28929Document.AcceptAllRevisions does not accept all revisionsBug
WORDSNET-28897ODT file fails to load with FileCorruptedExceptionBug
WORDSNET-28866Update Metered license codeBug
WORDSNET-28821NullReferenceException is thrown upon exporting to HTML with ExportListLabels.ByHtmlTagsBug
WORDSNET-28672DOCX to PDF: Additional spacing at the start of paragraphBug
WORDSNET-28604JoinRunsWithSameFormatting does not join runsBug
WORDSNET-28402Remove obsolete TableStyle.Bidi propertyBug
WORDSNET-28163Table is slightly shifted right after renderingBug
WORDSNET-26113Exporting list labels by HTML tags does not workBug

Public API and Backward Incompatible Changes

This section lists public API changes that were introduced in Aspose.Words 26.3. 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 ability to create instance of OpenAiModel class directly

Related issue: WORDSNET-28900

Now, you can create Aspose.Words.AI.OpenAiModel class directly.

/// <summary>
/// Class representing OpenAi models integration within Aspose.Words.
/// </summary>
/// <remarks>
/// Please refer to https://platform.openai.com/docs/models for OpenAi models details.
/// </remarks>
public class OpenAiModel : AiModel
/// <summary>
/// Initializes a new instance of <see cref="OpenAiModel"/> class.
/// </summary>
/// <param name="name">The name of the model. For example, gpt-5.2-chat-latest.</param>
public OpenAiModel(string name)
/// <summary>
/// Initializes a new instance of <see cref="OpenAiModel"/> class.
/// </summary>
/// <param name="name">The name of the model. For example, gpt-5.2-chat-latest.</param>
/// <param name="apiKey">The API key to use the OpenAi API.</param>
public OpenAiModel(string name, string apiKey)

This use case explains how to create instance of OpenAiModel class and summarize a document:

The functionality of JoinRunsWithSameFormatting method has been extended

Related issue: WORDSNET-28604

A new public method JoinRunsWithSameFormatting with the extended functionality has been added to Paragraph class:

/// <summary>
/// Joins runs with the same formatting in the paragraph.
/// </summary>
/// <param name = "options" > Additional options</param>
/// <returns>Number of joins performed. When <b>N</b> adjacent runs are being joined they count as <b>N - 1</b> joins.</returns>
public int JoinRunsWithSameFormatting(JoinRunsOptions options)

The new method takes the extended join runs operation options as a parameter:

/// <summary>
/// Provides configuration flags for the join runs operation.
/// </summary>
public class JoinRunsOptions
{
  /// <summary>
  /// True indicates that the spacing attributes of all runs will be ignored when joining runs with same formatting.
  /// </summary>
  public bool IgnoreSpacing { get; set; }

  /// <summary>
  /// True indicates that the redundant attributes of all runs will be ignored when joining runs with same formatting.
  /// </summary>
  public bool IgnoreRedundant { get; set; }

  /// <summary>
  /// True indicates that the insignificant attributes of all runs will be ignored when joining runs with same formatting.
  /// </summary>
  public bool IgnoreInsignificant { get; set; }
}

This use case explains how to work with JoinRunsWithSameFormatting(JoinRunsOptions options):

Removed obsolete TableStyle.Bidi property

Related issue: WORDSNET-28402

Removed obsolete Bidi property from Aspose.Words.TableStyle class:

/// <summary>
/// Gets or sets whether this is a style for a right-to-left table.
/// </summary>
[Obsolete("This property is obsolete and will be removed in future releases. The property is not applicable to a table style.")]
public bool Bidi

There is no such property in Word GUI for Table styles. Also, Word doesn’t allow to set this property for Table styles in VBA. Aspose.Words now also does not provide this property in the public API to mimic MS Word.