Aspose.Words for Java 26.2 Release Notes

Major Features

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

• Charts: Added the ability to set the orientation and rotation for both chart titles and axis titles.
• Mathematical Equations: Improved the rendering of EQ-matrix (MathML) elements for higher visual fidelity.
• Table Layout: Implemented the updated MS Word logic regarding the merging (or separation) of adjacent tables.
• Metered Licensing: Updated Metered Billing Code for Java.

Full List of Issues Covering all Changes in this Release

Public API and Backward Incompatible Changes

This section lists public API changes that were introduced in Aspose.Words 26.2. 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 set orientation and rotation of chart title and axis title

Related issue: WORDSNET-28864

The properties Orientation and Rotation have been added to the ChartTitle and ChartAxisTitle classes:

public class ChartTitle
{
    ...

    /// <summary>
    /// Gets or sets the orientation of the chart title text.
    /// </summary>
    /// <remarks>
    /// The default value is <see cref="ShapeTextOrientation.Horizontal"/>.
    /// </remarks>
    public ShapeTextOrientation Orientation { get; set; }

    /// <summary>
    /// Gets or sets the rotation of the chart title in degrees.
    /// </summary>
    /// <remarks>
    /// The range of acceptable values is from -180 to 180 inclusive. The default value is 0.
    /// </remarks>
    public int Rotation { get; set; }
}

public class ChartAxisTitle
{
    ...

    /// <summary>
    /// Gets or sets the orientation of the axis title text.
    /// </summary>
    /// <remarks>
    /// The default value is <see cref="ShapeTextOrientation.Horizontal"/>.
    /// </remarks>
    public ShapeTextOrientation Orientation { get; set; }

    /// <summary>
    /// Gets or sets the rotation of the axis title in degrees.
    /// </summary>
    /// <remarks>
    /// The range of acceptable values is from -180 to 180 inclusive.
    /// </remarks>
    public int Rotation { get; set; }
}

This use case explains how to set orientation and rotation of chart title and axis title:

Consecutive tables with different tblLayout values are no longer merged

Per WORSNET-28521, Aspose.Words behavior was changed so that consecutive tables with different tblLayout property values are no longer merged into a single table.

In MS Word, there is some logic that merges consecutive tables with similar properties into a single table. This might significantly affect table layout. For a long time, MS Word had been merging consecutive tables with different tblLayout values into a single table. The behavior was changed fairly recently at some time around March or April 2025. Since then, MS Word does not merge consecutive tables with different tblLayout values. There were several customer requests to imitate the new behavior. AW behavior now matches the current MS Word behavior in this respect.

The change actually breaks the expected layout for a some of older customer requests, specifically WORDSNET-13434, WORDSNET-20814 and some others. But that should not be a problem since the same change had already happened with MS Word layout for documents in those requests.