Browse our Products

Aspose.Words for .NET 23.9 Release Notes

Major Features

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

  • Added an ability to set axis title of charts.
  • Extended MarkdownSaveOptions with ImagesFolderAlias property.
  • Added an ability to specify fonts vertical position on a line for paragraph.
  • Implemented metafile rendering emulation of rasterization size for WMF pen width and EMF cosmetic pen.

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 23.9. 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 an ability to set chart axis title

Related issue: WORDSNET-24912

A new public class ChartAxisTitle has been implemented. And a property Title of this type has been added.

/// <summary>
/// Provides access to the axis title properties.
/// To learn more, visit the <a href="https://docs.aspose.com/words/net/working-with-charts/">Working with
/// Charts</a> documentation article.
/// </summary>
public class ChartAxisTitle
{
    /// <summary>
    /// Gets or sets the text of the axis title.
    /// If <c>null</c> or empty value is specified, auto generated title will be shown.
    /// </summary>
    /// <remarks>Use <see cref="Show"/> option if you need to show the title.</remarks>
    public string Text { get; set; }

    /// <summary>
    /// Determines whether other chart elements shall be allowed to overlap the title.
    /// The default value is <c>false</c>.
    /// </summary>
    public bool Overlay { get; set; }

    /// <summary>
    /// Determines whether the title shall be shown for the axis.
    /// The default value is <c>false</c>.
    /// </summary>
    public bool Show { get; set; }
}

public class ChartAxis
{
    /// <summary>
    /// Provides access to the axis title properties.
    /// </summary>
    public ChartAxisTitle Title { get; }
}

Added public property MarkdownSaveOptions.ImagesFolderAlias

Related issue: WORDSNET-21376

A new public property ImagesFolderAlias has been added to class MarkdownSaveOptions:

/// <summary>
/// Specifies the name of the folder used to construct image URIs written into a document.
/// </summary>
public string ImagesFolderAlias { get; set; }

Added public property ParagraphFormat.BaselineAlignment

Related issue: WORDSNET-25698

A new public property BaselineAlignment has been added to class ParagraphFormat and a new public enum has been introduced:

/// <summary>
/// Gets or sets fonts vertical position on a line.
/// </summary>
public BaselineAlignment BaselineAlignment { get; set; }

/// <summary>
/// Specifies fonts vertical position on a line.
/// </summary>
public enum BaselineAlignment

ScaleWmfFontsToMetafileSize property is replaced with EmulateRenderingToSizeOnPage and added EmulateRenderingToSizeOnPageResolution.

/// <summary>
/// Gets or sets a value determining whether metafile rendering emulates the display of the metafile according to the size on page
/// or the display of the metafile in its default size.
/// </summary>
/// <remarks>
/// <para>When metafiles are displayed in MS Word, some graphics may be scaled according to the actual metafile size in pixels.
/// I.e. even zooming may affect the metafile display.</para>
///
/// <p>When this value is set to <c>true</c>, Aspose.Words emulates rendering according to the metafile size on page.
/// The size in pixels is calculated from the metafile size on the page and the specified <see cref="EmulateRenderingToSizeOnPageResolution"/>.</p>
///
/// <p>When this value is set to <c>false</c>, Aspose.Words emulates metafile rendering to its default size in pixels.</p>
///
/// <p>This option is used only when metafile is rendered as vector graphics.</p>
///
/// <p>The default value is <c>true</c>.</p>
/// </remarks>
public bool EmulateRenderingToSizeOnPage { get; set; }

/// <summary>
/// Gets or sets the resolution in pixels per inch for the emulation of metafile rendering to the size on page.
/// </summary>
/// <remarks>
/// <p>This option is used only when <see cref="EmulateRenderingToSizeOnPage"/> is set to <c>true</c>.</p>
///
/// <p>The default value is 96. This is a default display resolution. I.e. metafile rendering will emulate the display of
/// the metafile in MS Word with a 100% zoom factor.</p>
/// </remarks>
public int EmulateRenderingToSizeOnPageResolution { get; set; }

Removed obsolete property ChildNodes from CompositeNode class

Related issue: WORDSNET-25439

The obsolete public property ChildNodes is removed from Aspose.Words.CompositeNode class. Note, the removed ChildNodes is equivalent to calling GetChildNodes(NodeType, bool) with arguments (NodeType.Any and false) Please check the following example:

Node[] children = source.GetChildNodes(NodeType.Any, false).ToArray();