Browse our Products
Aspose.Words for C++ 24.2 Release Notes
Major Features
There are 79 improvements and fixes in this regular monthly release. The most notable are:
- Introduced new public properties for enhanced style management.
- Added the capability to specify SvgSaveOptions during rendering using ShapeRenderer.Save() and OfficeMathRenderer.Save() methods.
- Enhanced functionality to retrieve the actual text of reference marks for footnotes and endnotes.
- Continued extending the DrawingML Chart API capabilities.
- Added an ability to preserve empty lines while loading Markdown files.
Full List of Issues Covering all Changes in this Release
Expand to view the full list of reported issues.
- Disable links in ToC when exporting to HTML
- Preserving Document Structure Post Content Control Removal
- Provide an ability to get/set styles priority
- Provide an ability to show/hide styles
- Allow passing SvgSaveOptions into ShapeRenderer.Save and OfficeMathRenderer.Save methods
- Font Control in Bar Chart
- StructuredDocumentTagRangeStart class Appearance property
- Errors with dates of 1900 year in charts
- Without explicitly specifying ‘LoadFormat.Markdown’, Aspose.Words cannot determine the MD format in the user’s MD file
- Text is lost after converting RTF to HTML
- Aspose.Words produces a invalid DOCX document
- Remove implicit call of Document.UpdateActualReferenceMarks from Footnote.ActualReferenceMark
- Equations are cut off when saving to PDF
- Table formatting is broken after open/save DOCX file
- Importing SVG file into document results with shifted head arrow
- Formatting missing for the custom bullet point(s)
- Make refactoring of MOBI/AZW3 import/export
- Href and target attributes of hyperlink is changed after inserting to document and saving to HTML
- FieldHyperlink.ScreenTip returns truncated value
- ArgumentException is thrown upon comparing document
- Vertical position of text in cell is wrong
- Table layout is changed after rendering
- Chinese text is improperly distributed after rendering
- FileCorruptedException is thrown upon loading DOC document
- Formatting of the document is broken after PDF to DOCX conversion
- DOCX to MD: Text after image is not indented
- Line break is added at the end of block level SDT
- System.Drawing.Image throws exceptions after using it in ImageData.SetImage
- Aspose.Words.FileCorruptedException is thrown while importing DOC
- FileCorruptedException while loading DOC
- FileCorruptedException is thrown upon loading DOC document
- Plain SDT is incorrectly inserted during comparison
- DOCX Content not Displayed on the Same Page in HTML FIXED Format
- DOCX to HtmlFixed conversion issue with shape (image) position
- Some content pushed to previous page in HTML_FIXED
- A line pushed to next page in PDF
- Line break not respected in PDF
- Content is pushed to the beginning of next line in PDF
- Comments content is marked as a revision after comparing document
- Stamp misplaced in Html Fixed
- Overlapped content and reduced number of pages when saving to PDF
- NullReferenceException is thrown when using ToString method on a cell with nested table and PreserveTableLayout option
- Content of first page spans across two pages during ODT to DOCX conversion
- Heading style formatting is lost after open/save document
- Spacing before semicolon is less then expected
- DOCX to MD: Multi-line remarks issue
- DOCX to MD: Examples block not converted correctly
- DOCX to MD: Indentations not working correctly
- ArgumentOutOfRangeException is thrown upon updating page layout in Linux
- Hidden content becomes visible in output PDF
- The combination of a comma and nine spaces is used as line break in MathFormula
- Page number is incorrect after rendering document
- Add resilience by ignoring Spaces at start/end of each Row during Markdown Table import
- Proxy error(ArgumentOutOfRangeException) occurs upon converting OfficeMath to html string in linux
- Table formatting is broken after open/save DOC file
- Characters overlap in Chinese text
- Links don’t work in AZW3/MOBI documents generated with HtmlVersion.Html5
- Position of page numbers in TOC is shifted after rendering
- Images are scaled down even if HtmlSaveOptions.ScaleImageToShapeSize is set to false
- The “Slash” should be used as LineBreak in Math formula
- Empty lines are lost after importing MD document
- Text misaligned in uppercase roman styled list when is aligned to Left
- Number of Pages reduced during rendering DOCX to PDF
- Content moves to next pages in PDF
- Extra whitespaces are added to merge field value after formatting number
- Forward text is not inserted after executing mail merge
- DOCX to HTML: Single page converted to multiple pages
- Memory leak upon creating document.
- Table Border Lost for Inline Component
- Nested content controls CXP is not updating
- DOCX to PDF: Chinese characters not rendered correctly
- JPEG image is loaded as TXT document by Aspose.Words
- DOCX to PDF conversion issue with row height
- Number format is incorrect when “fr-BE” culture is used.
- DOC to PCL: Saving using MemoryStream incorrectly rendered
- System.InvalidCastException occurs during comparing Word documents
- Consider adding an option to preserve empty paragraphs upon exporting to MD
- Formatting of document is incorrect after PDF to DOCX conversion
- Pdf2Word.PdfImageBuilder throws IndexOutOfRangeException
Public API and Backward Incompatible Changes
This section lists public API changes that were introduced in Aspose.Words 23.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 an ability to preserve empty lines while loading Markdown files.
Implemented new public classes with a new public property:
/// Allows to specify additional options when loading LoadFormat::Markdown document into a Document object.
class ASPOSE_WORDS_SHARED_CLASS MarkdownLoadOptions
{
...
/// Gets or sets a boolean value indicating whether to preserve empty lines while loading a LoadFormat::Markdown document.
/// The default value is false.
/// Normally, empty lines between block-level elements in Markdown are ignored. Empty lines at the beginning and
/// end of the document are also ignored. This option allows to import such empty lines.
ASPOSE_WORDS_SHARED_API bool get_PreserveEmptyLines() const;
ASPOSE_WORDS_SHARED_API void set_PreserveEmptyLines(bool value);
};
Introduced new public properties for enhanced style management.
A new public properties Priority, UnhideWhenUsed, and SemiHidden have been added to the class Style.
/// Gets/sets the integer value that represents the priority for sorting the styles in the Styles task pane.
int get_Priority();
void set_Priority(int value);
/// Gets/sets whether the style used in the current document unhides from the Styles gallery and from the Styles task pane.
bool get_UnhideWhenUsed();
void set_UnhideWhenUsed(bool value);
/// Gets/sets whether the style hides from the Styles gallery and from the Styles task pane.
bool get_SemiHidden();
void set_SemiHidden(bool value);
Added NodeRendererBase.Save() methods that accept SvgSaveOptions.
New public methods have been added to class NodeRendererBase allowing to pass SvgSaveOptions:
/// Renders the shape into an SVG image and saves into a file.
ASPOSE_WORDS_SHARED_API void Save(const System::String& fileName, System::SharedPtr<Aspose::Words::Saving::SvgSaveOptions> saveOptions);
/// Renders the shape into an SVG image and saves into a stream.
ASPOSE_WORDS_SHARED_API void Save(const System::SharedPtr<System::IO::Stream>& stream, System::SharedPtr<Aspose::Words::Saving::SvgSaveOptions> saveOptions);
Added public property Appearance to the StructuredDocumentTagRangeStart class.
A new public property Appearance has been added to class StructuredDocumentTagRangeStart and IStructuredDocumentTag interface:
/// Gets or sets the appearance of the structured document tag.
ASPOSE_WORDS_SHARED_API Aspose::Words::Markup::SdtAppearance get_Appearance() override;
ASPOSE_WORDS_SHARED_API void set_Appearance(Aspose::Words::Markup::SdtAppearance value) override;
Added public property Footnote.ActualReferenceMark and public method Document.UpdateActualReferenceMarks.
An ability to get the actual text of reference marks for footnotes and endnotes has been implemented.
The following new public members have been added to the Footnote and Document classes:
/// Gets the actual text of the reference mark displayed in the document for this footnote.
ASPOSE_WORDS_SHARED_API System::String get_ActualReferenceMark();
/// Updates the Footnote::ActualReferenceMark property of all footnotes and endnotes in the document.
ASPOSE_WORDS_SHARED_API void UpdateActualReferenceMarks();
Continued extending the DrawingML Chart API capabilities.
A new class AxisTickLabels has been implemented. The properties related to axis tick mark labels have been marked as obsolete in the ChartAxis class and moved to the new class. A property TickLabels of the AxisTickLabels type has been added to the ChartAxis class.
Also, the ability to set font formatting for tick mark labels has been implemented: a new AxisTickLabels.Font property has been added.
And a Format property, which allows defining line formatting for an axis and fill for tick mark labels, has been added to the ChartAxis class.
/// Represents properties of axis tick mark labels.
class ASPOSE_WORDS_SHARED_CLASS AxisTickLabels
{
/// Gets or sets the position of the tick labels on the axis.
ASPOSE_WORDS_SHARED_API Aspose::Words::Drawing::Charts::AxisTickLabelPosition get_Position();
ASPOSE_WORDS_SHARED_API void set_Position(Aspose::Words::Drawing::Charts::AxisTickLabelPosition value);
/// Gets or sets the distance of the tick labels from the axis.
ASPOSE_WORDS_SHARED_API int32_t get_Offset();
ASPOSE_WORDS_SHARED_API void set_Offset(int32_t value);
/// Gets or sets the interval at which the tick labels are drawn.
ASPOSE_WORDS_SHARED_API int32_t get_Spacing();
ASPOSE_WORDS_SHARED_API void set_Spacing(int32_t value);
/// Gets or sets a flag indicating whether to use automatic interval for drawing the tick labels.
ASPOSE_WORDS_SHARED_API bool get_IsAutoSpacing();
ASPOSE_WORDS_SHARED_API void set_IsAutoSpacing(bool value);
/// Gets or sets text alignment of the axis tick labels.
ASPOSE_WORDS_SHARED_API Aspose::Words::ParagraphAlignment get_Alignment();
ASPOSE_WORDS_SHARED_API void set_Alignment(Aspose::Words::ParagraphAlignment value);
/// Provides access to font formatting of the tick labels.
ASPOSE_WORDS_SHARED_API System::SharedPtr<Aspose::Words::Font> get_Font();
};
class ASPOSE_WORDS_SHARED_CLASS ChartAxis
{
/// Provides access to the properties of the axis tick mark labels.
ASPOSE_WORDS_SHARED_API System::SharedPtr<Aspose::Words::Drawing::Charts::AxisTickLabels> get_TickLabels();
/// Provides access to line formatting of the axis and fill of the tick labels.
ASPOSE_WORDS_SHARED_API System::SharedPtr<Aspose::Words::Drawing::Charts::ChartFormat> get_Format();
};
A new public class ChartDataTable has been implemented. A property DataTable of this type has been added to the Chart class:
/// Allows to specify properties of a chart data table.
class ASPOSE_WORDS_SHARED_CLASS ChartDataTable
{
/// Gets or sets a flag indicating whether the data table will be shown for the chart.
ASPOSE_WORDS_SHARED_API bool get_Show() const;
ASPOSE_WORDS_SHARED_API void set_Show(bool value);
/// Gets or sets a flag indicating whether legend keys are displayed in the data table.
ASPOSE_WORDS_SHARED_API bool get_HasLegendKeys() const;
ASPOSE_WORDS_SHARED_API void set_HasLegendKeys(bool value);
/// Gets or sets a flag indicating whether a horizontal border of the data table is displayed.
ASPOSE_WORDS_SHARED_API bool get_HasHorizontalBorder() const;
ASPOSE_WORDS_SHARED_API void set_HasHorizontalBorder(bool value);
/// Gets or sets a flag indicating whether a vertical border of the data table is displayed.
ASPOSE_WORDS_SHARED_API bool get_HasVerticalBorder() const;
ASPOSE_WORDS_SHARED_API void set_HasVerticalBorder(bool value);
/// Gets or sets a flag indicating whether an outline border, that is, a border around series and category names, is displayed.
ASPOSE_WORDS_SHARED_API bool get_HasOutlineBorder() const;
ASPOSE_WORDS_SHARED_API void set_HasOutlineBorder(bool value);
/// Provides access to font formatting of the data table.
ASPOSE_WORDS_SHARED_API System::SharedPtr<Aspose::Words::Font> get_Font();
/// Provides access to fill of text background and border formatting of the data table.
ASPOSE_WORDS_SHARED_API System::SharedPtr<Aspose::Words::Drawing::Charts::ChartFormat> get_Format();
};
class ASPOSE_WORDS_SHARED_CLASS Chart
{
/// Provides access to properties of a data table of this chart.
ASPOSE_WORDS_SHARED_API System::SharedPtr<Aspose::Words::Drawing::Charts::ChartDataTable> get_DataTable();
};
Limitations and API Differences
Aspose.Words for C++ has some differences as compared to its equivalent .NET version of the API. This section contains information about all such functionality that is not available in the current release. The missing features will be added in future releases.
- The current release does not support Metered license.
- The current release does not support LINQ and Reporting features.
- The current release does not support OpenGL 3D Shapes rendering.
- The current release does not support loading PDF documents.
- The current release has limited support for database features - C++ doesn’t have common API for DB like .NET System.Data.
- The current release supports Microsoft Visual C++ version 2017 or higher.
- The current release supports GCC 6.3 or higher and Clang 3.9.1 or higher on Linux and only for the x86_x64 platform.
- The current release supports macOS Big Sur or later (11.5+) for 64-bit Intel Mac platform.