Browse our Products

Aspose.Words for .NET 24.10 Release Notes

Major Features

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

  • Enhanced ActiveX Control Support: Introduced the ability to create CommandButton ActiveX controls.
  • Shape Visibility Control: Added a new public property Shape.Hidden to control the visibility of shapes.
  • Group Shape Insertion: Added ability to group individual shapes, group shapes together, and directly group both shapes and group shapes.
  • Markdown Export Options: Incorporated an option to export tables as HTML when saving documents to Markdown format.
  • Pie and Doughnut Chart Formatting: Added public properties to format Pie and Doughnut charts.
  • Big5 Encoding Support: Improved handling of Big5 encoding for TrueType cmap tables.
  • Outdated Taiwanese Font Handling: Enhanced support for outdated Taiwanese fonts.

Full List of Issues Covering all Changes in this Release

Expand to view the full list of issues.
KeySummaryCategory
WORDSNET-27373Add overload of InsertGroupShape to group GroupShapesNew Feature
WORDSNET-26193Make ShapeBase.Hidden property publicNew Feature
WORDSNET-16356Add feature to create CommandButton ActiveXNew Feature
WORDSNET-17134Manipulation of Doughnut Chart StyleNew Feature
WORDSNET-26995Aspose.Words support save as “Web page, Filtered” formatNew Feature
WORDSNET-22965Add feature to get ChartType of chartNew Feature
WORDSNET-27420Support for PCL5New Feature
WORDSNET-13454Image wrapping problem and some content moves to previous page in PDFEnhancement
WORDSNET-27260Chart is rendered improperlyEnhancement
WORDSNET-26970Comparison shows wrong SDT tagEnhancement
WORDSNET-27211Corrupted DOCX document is loaded as TXT if load from streamBug
WORDSNET-25819Exception is thrown upon comparing documentBug
WORDSNET-26080InvalidOperationException is thrown upon comparing documentBug
WORDSNET-26251NC sync error occurs when comparing docx documentsBug
WORDSNET-27261Comparison throws NC sync failed exceptionBug
WORDSNET-27329Document.Compare throws System.InvalidOperationExceptionBug
WORDSNET-27274Compare throws System.InvalidOperationException: NC sync failedBug
WORDSNET-25378Aspose.Words 23.5 Throws “ArgumentOutOfRangeException” when comparing Word documentsBug
WORDSNET-27310Formula fields are updated improperlyBug
WORDSNET-27359ArithmeticException is thrown upon rendering document to PDFBug
WORDSNET-25909XPS Viewer shows broken signature warning in XPS signed by Aspose.WordsBug
WORDSNET-27355Compare lists content controls as modifiedBug
WORDSNET-27328Inconsistent XmlMapping.IsMapped property behavior with CustomXmlPart null value in SDTsBug
WORDSNET-27004Incorrect wrapping of the justified lineBug
WORDSNET-26739DOCX to PDF: Values from Chart axes not renderedBug
WORDSNET-25095Pie charts are rendered with less radiusBug
WORDSNET-27325NullReferenceException while reading HTMLBug
WORDSNET-27036“RemoveContainingFields” cleanup option removes Hyperlink field in Mail MergeBug
WORDSNET-27062Chinese file names inside the epub file garbled after conversionBug
WORDSNET-26913Aspose.Words allows adding custom document property with name that starts with digits that produced an invalid XMLBug
WORDSNET-27292Ranged SDT ids are duplicated in ‘foreach’Bug
WORDSNET-27397Aspose.Words produces a corrupted document after removing framesBug
WORDSNET-27424Pdf2Word hangs upon loading documentBug
WORDSNET-27408Exported OLE objects from RTF cannot be opened within respective toolBug
WORDSNET-27382Consider providing an option to export tables as HTML when saving document to MarkdownBug
WORDSNET-27317Aspose.Words loads PDF document very slowBug
WORDSNET-27351Redundant footer is added in the extracted pageBug
WORDSNET-27296Aspose.Words hangs upon loading PDF documentBug
WORDSNET-27383Footer is changed after open/save document.Bug
WORDSNET-27369Linked text box chain is not loaded into the modelBug
WORDSNET-27360Webpage to MHTML conversion produces empty documentBug
WORDSNET-26631Table overlaps list item text on DOC to PDF conversionBug
WORDSNET-27207Can’t add a paragraph to even pagesBug
WORDSNET-27378ArgumentException is thrown upon rendering documentBug
WORDSNET-27379Image Color Conversion Issue When Saving DOCX as PDFBug
WORDSNET-27289Image color is changed after rendering in .NET StandardBug
WORDSNET-27225Line is lost after rendering document as HtmlFixedBug
WORDSNET-27393DOCX to PDF: Chinese font not applied in output PDF fileBug
WORDSNET-27381List items positions are changed after PDF to DOCX conversionBug
WORDSNET-27316ArgumentException is thrown upon rendering documentBug
WORDSNET-27371Gradient is lost after rendering document to imageBug
WORDSNET-27389DOCX to PDF: Fonts are substituted even though they are available in the fonts folder or installed on the systemBug
WORDSNET-27118LINQ Reporting Engine template syntax is not processed in textbox SDTBug
WORDSNET-27226Chart is rendered improperlyBug
WORDSNET-27350Chart with logarithmic axis scaling is rendered improperlyBug
WORDSNET-27191Hyperlink is changed after converting DOCX to DOCBug
WORDSNET-25527MailMergeSettings.Query does not work if path to data source contains ‘#’Bug
WORDSNET-27193ArgumentNullException is thrown upon using Document.ExtractPages with hyphenationBug
WORDSNET-27339Characters getting cut off when converting DOCX to PDFBug
WORDSNET-27091Columns width issue on saving to XLSXBug
WORDSNET-27215XmlException is thrown upon loading ODT documentBug
WORDSNET-27286PDF produced by Aspose.Words shows warnings upon validation PDF/UA complicanceBug
WORDSNET-27178Bad quality of ePub to DOCX conversionBug
WORDSNET-26987Resultant file is corrupt when saving it to the same streamBug
WORDSNET-27168DATE field with french formatting change value to english formatting (DOCX to PDF)Bug
WORDSNET-27400Platform issue while running on modern os versionsBug
WORDSNET-27301DOCX to PDF rendering issue with Thai charBug
WORDSNET-27344Position of page numbers in TOC are not lined in HTMLBug
WORDSNET-27357Cell level SDT is not exported to PDF as editable checkboxBug
WORDSNET-27279Formatting lost after loading from HTMLBug
WORDSNET-25815DOCX to MD: Code blocks not converted correctlyBug
WORDSNET-27006Document corrupted exceptionBug
WORDSNET-21361Table Indent property changed after converted from Word to HTML to wordBug
WORDSNET-27264MailMerge number format in fr_CH localeBug
WORDSNET-17545Document.UpdateFields does not update HYPERLINK field, leaving its result as “Error! Hyperlink reference not valid”Bug

Public API and Backward Incompatible Changes

This section lists public API changes that were introduced in Aspose.Words 24.10. 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 CommandButton ActiveX control

Related issue: WORDSNET-16356

Added a new public method to Aspose.Words.DocumentBuilder class:

/// <summary>
/// Inserts <see cref="Forms2OleControl"/> object into current position.
/// </summary>
/// <returns><see cref="Shape"/> object that contains passed <see cref="Forms2OleControl"/></returns>
/// <seealso cref="Shape.OleFormat"/><seealso cref="OleFormat.OleControl"/>.
public Shape InsertForms2OleControl(Forms2OleControl forms2OleControl)

Also added a new public class to Aspose.Words.Drawing.Ole namespace:

/// <summary>
/// The CommandButton control runs a macro that performs an action when a user clicks it.
/// </summary>
public class CommandButtonControl : Forms2OleControl

This use case explains how to insert CommandButton ActiveX control:

Added new public property Shape.Hidden

Related issue: WORDSNET-26193

A new public property Hidden has been added to ShapeBase class:

/// <summary>
/// Gets or sets a boolean value indicating whether the shape is visible.
/// </summary>
/// <remarks>
/// The default value is <c>false</c>.
/// </remarks>
public bool Hidden { get; set; }

This use case explains how to use Hidden property:

Added option that allows to export tables as HTML when saving document to Markdown

Related issue: WORDSNET-27382

Added a new public option to Aspose.Words.Saving.MarkdownSaveOptions class:

/// <summary>
/// Allows to specify the elements to be exported to Markdown as raw HTML.
/// Default value is <see cref="MarkdownExportAsHtml.None"/>.
/// </summary>
public MarkdownExportAsHtml ExportAsHtml { get; set; }

And also a new public enumeration to Aspose.Words.Saving namespace:

/// <summary>
/// Allows to specify the elements to be exported to Markdown as raw HTML.
/// </summary>
public enum MarkdownExportAsHtml

This use case explains how to export table as raw HTML when saving to Markdown:

Added public properties to format Pie and Doughnut charts

Related issue: WORDSNET-17134

The following public properties have been added to the ChartSeriesGroup class for formatting Pie and Doughnut charts:

/// <summary>
/// Gets or sets the angle, in degrees, of the first slice of the parent pie chart.
/// </summary>
/// <remarks>
/// Applies to series groups of the <see cref="ChartSeriesType.Pie"/>, <see cref="ChartSeriesType.Pie3D"/>
/// and <see cref="ChartSeriesType.Doughnut"/> types.
/// The range of acceptable values is from 0 to 360 inclusive. The default value is 0.
/// </remarks>
public int FirstSliceAngle { get; set; }

/// <summary>
/// Gets or sets the hole size of the parent doughnut chart as a percentage.
/// </summary>
/// <remarks>
/// Applies only to series groups of the <see cref="ChartSeriesType.Doughnut"/> type.
/// The range of acceptable values is from 0 to 90 inclusive. The default value is 75.
/// </remarks>
public int DoughnutHoleSize { get; set; }

/// <summary>
/// Gets or sets the size of the pie chart secondary section as a percentage.
/// </summary>
/// <remarks>
/// Applies to series groups of the <see cref="ChartSeriesType.PieOfPie"/> and
/// <see cref="ChartSeriesType.PieOfBar"/> types.
/// The range of acceptable values is from 5 to 200 inclusive. The default value is 75.
/// </remarks>
public int SecondSectionSize { get; set; }

This use case explains how to create and format Doughnut chart:

This use case explains how to create and format Pie of Pie chart:

New public methods DocumentBuilder.InsertGroupShape has been introduced

Related issue: WORDSNET-27373

A new InsertGroupShape() public methods in DocumentBuilder class has been introduced:

/// <summary>
/// Groups the shapes passed as a parameter into a new GroupShape node which is inserted into the current position.
/// </summary>
/// <param name="shapes">The list of shapes to be grouped.</param>
/// <remarks>
/// <p>The position and dimension of the new GroupShape will be calculated automatically.</p>
/// <p>VML and DML shapes cannot be grouped together.</p>
/// </remarks>
public GroupShape InsertGroupShape(params ShapeBase[] shapes)

/// <summary>
/// Groups the shapes passed as a parameter into a new GroupShape node of the specified size which is inserted into the specified position.
/// </summary>
/// <param name="left">Distance in points from the origin to the left side of the group shape.</param>
/// <param name="top">Distance in points from the origin to the top side of the group shape.</param>
/// <param name="width">The width of the group shape in points. A negative value is not allowed.</param>
/// <param name="height">The height of the group shape in points. A negative value is not allowed.</param>
/// <param name="shapes">The list of shapes to be grouped.</param>
/// <remarks>
/// VML and DML shapes cannot be grouped together.
/// </remarks>
public GroupShape InsertGroupShape(double left, double top, double width, double height, params ShapeBase[] shapes)

It is now possible to group individual shapes, group shapes together, and directly group both shapes and group shapes.

This use case explains how to work with InsertGroupShape() methods: