Aspose.Words for C++ 21.4 Release Notes

This page contains release notes for Aspose.Words for C++ 21.4

Major Features

We have added the following features from Aspose.Words for .NET on this regular monthly release:

• Added an ability to remove unused BuiltIn Styles.
• The Fill class was extended with a functionality for processing solid fills.
• Public API of Structured Document Tag range was extended.

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 advanced typography based on HarfBuzz shaper.
• 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.

Full List of Issues Covering all Changes in this Release

Key	Summary	Category
WORDSNET-21246	Provide more properties/methods in StructuredDocumentTagRangeStart Class	New Feature
WORDSNET-5643	Consider providing a way to save user specified page ranges when saving to flow formats	Enhancement
WORDSNET-20580	Improve list item padding simulation in Html list writer	Enhancement
WORDSNET-21597	Add “IsDecorative” flag for DML shapes	Enhancement
WORDSNET-3449	Improve support of large files	Enhancement
WORDSNET-21966	DOCX to PDF conversion: System.ArgumentOutOfRangeException: ‘Index was out of range.	Bug
WORDSNET-21801	URL is changed after Word to PDF conversion	Bug
WORDSNET-20987	Unexpected format change revision appears for a Table after Compare	Bug
WORDSNET-20190	Chart series are lost after DOCX to PDF conversion	Bug
WORDSNET-20191	Chart X-axis and Axis Title render incorrectly in output PDF	Bug
WORDSNET-22024	System.InvalidOperationException: NC sync failed occurs upon comparing DOCX files	Bug
WORDSNET-22016	Provide example to process BARCODE fields	Bug
WORDSNET-21400	Aspose.Words enters a infinite loop when converting file from DOCX to PDF	Bug
WORDSNET-21636	Content formatting changed after delete XmlMapping	Bug
WORDSNET-21977	Unused styles are not cleaned from DOCX	Bug
WORDSNET-21979	Does not update SDT content in document.xml parts after calling UpdatePageLayout()	Bug
WORDSNET-21981	FileCorruptedException is thrown while importing DOC	Bug
WORDSNET-21983	Uneoected FileCorruptedException is thrown while importing document	Bug
WORDSNET-20758	Table does not export correctly in output PDF	Bug
WORDSNET-21986	Track changes - Ghost formatted table	Bug
WORDSNET-21959	DOCX to HTML: Incorrect SVG image rendering	Bug
WORDSNET-21997	w:instrText is added in document header after re-saving DOCX	Bug
WORDSNET-21999	System.ArgumentOutOfRangeException is thrown while saving DOCX to PDF	Bug
WORDSNET-21998	w:instrText is added in comments.xml after re-saving DOCX	Bug
WORDSNET-16679	Metafile is rendered improperly	Bug
WORDSNET-16689	Spacing between asian and latin numbers is rendered improperly	Bug
WORDSNET-4539	Setting FormField text to empty does not display default text in MS Word	Bug
WORDSNET-16698	When MetafileRenderingMode.Bitmap is used, quality of image is not good	Bug
WORDSNET-20597	Incorrect automatic font color inside VML shape	Bug
WORDSNET-21663	Vertical Chinese Text Collapses into a Single Line in HTML Fixed	Bug
WORDSNET-16509	Not able to save as PDF	Bug
WORDSNET-16971	Cell background color is incorrect in .NET Standard	Bug
WORDSNET-21838	Docx -> PDF: conversion never ends for a file	Bug
WORDSNET-21862	Conversion from ODT to PDF throws IndexOutOfRangeException	Bug
WORDSNET-21680	Missed footnotes during conversion between DOCX and Markdown	Bug
WORDSNET-21875	Table rows are lost after PDF to DOCX conversion	Bug
WORDSNET-18770	Unable to save the HTML version of DOCX file	Bug
WORDSNET-18092	Document.UpdateFields method throws System.InvalidOperationException	Bug
WORDSNET-21330	Rendering of some Japanese characters changes their orientation	Bug
WORDSNET-21886	Hyperlink DisplayResult not present in result DOTX document	Bug
WORDSNET-21859	Text from paragraphs with zero line spacing becomes visible in rendered documents	Bug
WORDSNET-18969	List bullet image is duplicated after conversion to HTML	Bug
WORDSNET-21685	Image dimension is changed while importing Markdown	Bug
WORDSNET-21691	ArgumentOutOfRangeException is thrown when call UpdatePageLayout	Bug
WORDSNET-15169	Direction of Text Characters is changed in DOCX to JPG conversion	Bug
WORDSNET-21096	Infinite loop on call of UpdatePageLayout	Bug
WORDSNET-21899	DOC to PDF conversion issue with Chinese text rendering	Bug
WORDSNET-21722	Some tests fail sometimes while running in parallel	Bug
WORDSNET-21435	Styles are not imported correctly after HTML to DOCX conversion	Bug
WORDSNET-21733	Combo Custom Combination Chart - Updating a Combinated Chart Corrupts Document	Bug
WORDSNET-21151	Bar char is not rendered correctly	Bug
WORDSNET-21910	System.IndexOutOfRangeException occurs upon DOCX to PDF conversion	Bug
WORDSNET-21911	System.ArgumentOutOfRangeException occurs upon Word DOCX to PDF conversion	Bug
WORDSNET-21912	Word to PDF conversion never ends for a DOC File	Bug
WORDSNET-20607	Contents are pushed down to next page in output PDF	Bug
WORDSNET-21188	An interval between list label end and first line text is different depending on HtmlSaveOptions.PrettyFormat	Bug
WORDSNET-21602	Table row is lost when HTML and Table is inserted into document using DocumentBuilder	Bug
WORDSNET-21604	Infinite loop during call of Document.UpdatePageLayout	Bug
WORDSNET-21748	System.ArgumentOutOfRangeException for UpdatePageLayout method	Bug
WORDSNET-21484	Incorrectly displayed form fields in PDF when viewed in Google Chrome Web Browser	Bug
WORDSNET-21844	Line extends out of bounds in pdf file after saving DPCX to PDF	Bug
WORDSNET-21763	DOCX to TIFF conversion issue with simplified Arabic text rendering	Bug
WORDSNET-21929	Text is moved to previous line after DOCX to PDF conversion	Bug
WORDSNET-21928	Barcode position is changed after DOC to PDF conversion	Bug
WORDSNET-21800	Japanese top to down text issue when converting DOCX to HTML	Bug
WORDSNET-21607	New style introduced after adding a new SDT	Bug
WORDSNET-21592	Links are broken when rendering CHM files to HTML	Bug
WORDSNET-13730	System.TypeInitializationException is thrown while loading Document	Bug
WORDSNET-21930	DOCX to PDF conversion issue with background	Bug
WORDSNET-18507	DOC to HtmlFixed conversion issue with table rendering	Bug
WORDSNET-21935	Table row is shifted towards left side of page after DOCX to PDF conversion	Bug
WORDSNET-21649	Bookmarks are lost after initiating LayoutEnumerator	Bug
WORDSNET-21939	FileCorruptedException occurs upon loading a DOCX	Bug
WORDSNET-21797	DOCX to PDF/A conversion and validation fails: Table spanned over 2 pages is tagged as two tables instead of one.	Bug
WORDSNET-21761	Conversion process hangs on Linux	Bug
WORDSNET-19297	Layout difference for the document	Bug
WORDSNET-21978	Document.Cleanup() not removing all unused Styles and Lists	Bug
WORDSNET-13487	Watermark positioning is incorrect in PDF	Bug
WORDSNET-16697	TryParse does not work for “fr-CH”	Bug
WORDSNET-20979	text-align : left style inside table column is not exported in output HTML	Bug
WORDSNET-16683	Document has incorrect tab size	Bug
WORDSNET-16705	Original date value is incorrect	Bug
WORDSNET-21518	Nested Textboxes inside Tables are missing in generated HTML	Bug
WORDSNET-12069	Extra empty page appears after conversion form DOCX to PDF	Bug
WORDSNET-12153	Contents position is changed after conversion from DOCX to PDF	Bug
WORDSNET-12393	Some Tables are pushed to next page in rendered document	Bug
WORDSNET-20242	DOC to HtmlFixed conversion is incorrect when HtmlFixedSaveOptions.ResourcesFolder is used	Bug
WORDSNET-13531	Incorrect conversion from DOCX to PDF	Bug
WORDSNET-20729	MHTML to PDF conversion hangs	Bug
WORDSNET-16722	Document has incorrect field values	Bug

Public API and Backward Incompatible Changes

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

Aspose::Wordsx::Comparing namespace was introduced

Due to refactoring work on Aspose.Words namespaces, CompareOptions, ComparisonTargetType, Granularity classes were moved to new separate namespace Aspose::Words::Comparing. In case of compilation error - please add using namespace Aspose::Words::Comparing and fix corresponding include directives - please check API Reference Documentation for a correct include paths.

Aspose::Words::Notes namespace was introduced

Due to refactoring work on Aspose.Words namespaces, Footnote, EndnoteOptions, FootnoteOptions, EndnotePosition, FootnotePosition, FootnoteType, FootnoteNumberingRule classes were moved to new separate namespace Aspose::Words::Notes. In case of compilation error - please add using namespace Aspose.Words.Notes and fix corresponding include directives - please check API Reference Documentation for a correct include paths.

The classes related to load options were moved to Aspose::Words::Loading namespace

Due to refactoring work on Aspose.Words namespaces, LoadOptions, PdfLoadOptions, RtfLoadOptions, TxtLoadOptions classes and corresponding enums were moved to Aspose.Words.Loading namespace. In case of compilation error - please add using namespace Aspose::Words::Loading and fix corresponding include directives - please check API Reference Documentation for a correct include paths.

Added a new public property CleanupOptions.UnusedBuiltinStyles

Related issue: WORDSNET-21977

Added a new public property to CleanupOptions:

/// <summary>
/// Specifies that unused BuiltIn styles should be removed from document.
/// </summary>
public bool UnusedBuiltinStyles { get; set; }

Use Case: Explains how to use UnusedBuiltinStyles property.

auto doc = MakeObject<Document>(u"input.docx");
auto cleanupOptions = MakeObject<CleanupOptions>();
cleanupOptions->set_UnusedBuiltinStyles(true);
doc->Cleanup(cleanupOptions);

Fill::Solid() method was introduced

Related issue: WORDSNET-21808

The following new public methods were added into the Fill class:

/// <summary>
/// Sets the fill to a uniform color.
/// </summary>
/// <remarks>
/// Use this method to convert any of the fills back to solid fill.
/// </remarks>
public void Solid()
 
/// <summary>
/// Sets the fill to a specified uniform color.
/// </summary>
/// <remarks>
/// Use this method to convert any of the fills back to solid fill.
/// </remarks>
public void Solid(Color color)

Use Case: Explains how to change fill to Solid.

// Open some document with text effects.
auto doc = MakeObject<Document>(u"TextTwoColorGradient.docx");
 
// Get Fill object for Font of the first Run.
auto fill = doc->get_FirstSection()->get_Body()->get_FirstParagraph()->get_Runs()->idx_get(0)->get_Font()->get_Fill();
 
// Check Fill properties of the Font.
std::cout << "The type of the fill is: " << System::ObjectExt::ToString(fill->get_FillType()).ToUtf8String() << '\n';
std::cout << "The foreground color of the fill is: " << fill->get_ForeColor()->ToString().ToUtf8String() << '\n';
std::cout << "The fill is transparent at " << fill->get_Transparency() * 100 << "%\n\n";
 
// Change type of the fill to Solid with uniform green color.
fill->Solid(Color::get_Green());
std::cout << "The fill is changed:\n";
std::cout << "The type of the fill is: " << System::ObjectExt::ToString(fill->get_FillType()).ToUtf8String() << '\n';
std::cout << "The foreground color of the fill is: " << fill->get_ForeColor()->ToString().ToUtf8String() << '\n';
std::cout << "The fill is transparent at " << fill->get_Transparency() * 100 << "%\n";
 
doc.Save("TextSolidOut.docx");
 
/*
This code example produces the following results:
 
The type of the fill is: Gradient
The foreground color of the fill is: Color [A=255, R=0, G=128, B=128]
The fill is transparent at 65%
 
The fill is changed:
The type of the fill is: Solid
The foreground color of the fill is: Color [A=255, R=0, G=128, B=0]
The fill transparency is 0%
*/

Public API of Structured Document Tag range was extended

Related issue: WORDSNET-21246

The constructors for StructuredDocumentTagRangeStart and StructuredDocumentTagRangeEnd classes have been made public. Now the instances of these classes can be created manually.

/// <summary>
/// Initializes a new instance of the <b>Structured document tag range start</b> class.
/// </summary>
/// <remarks>
/// <para>The following types of SDT can be created:</para>
/// <list type="bullet">
/// <item><see cref="Markup.SdtType.Checkbox"/></item>
/// <item><see cref="Markup.SdtType.DropDownList"/></item>
/// <item><see cref="Markup.SdtType.ComboBox"/></item>
/// <item><see cref="Markup.SdtType.Date"/></item>
/// <item><see cref="Markup.SdtType.BuildingBlockGallery"/></item>
/// <item><see cref="Markup.SdtType.Group"/></item>
/// <item><see cref="Markup.SdtType.Picture"/></item>
/// <item><see cref="Markup.SdtType.RichText"/></item>
/// <item><see cref="Markup.SdtType.PlainText"/></item>
/// </list>
/// </remarks>
/// <param name="doc">The owner document.</param>
/// <param name="type">Type of SDT node.</param>
public StructuredDocumentTagRangeStart(DocumentBase doc, SdtType type)
 
/// <summary>
/// Initializes a new instance of the <b>Structured document tag range end</b> class.
/// </summary>
/// <param name="doc">The owner document.</param>
/// <param name="id">Identifier of the corresponding structured document tag range start.</param>
public StructuredDocumentTagRangeEnd(DocumentBase doc, int id)

Use Case:

auto doc = MakeObject<Document>(u"input.docx");
 
auto start = MakeObject<StructuredDocumentTagRangeStart>(doc, SdtType::RepeatingSectionItem);
auto end = MakeObject<StructuredDocumentTagRangeEnd>(doc, start->get_Id());
 
doc->get_FirstSection()->get_Body()->InsertAfter(start, doc->get_FirstSection->get_Body()->get_FirstParagraph());
doc->get_LastSection()->get_Body()->InsertBefore(end, doc->get_LastSection()->get_Body()->get_LastParagraph());
 
doc->Save(u"output.docx");

A new public RemoveAllChildren() method has been added.

/// <summary>
/// Removes all the nodes between this range start node and the range end node.
/// </summary>
public void RemoveAllChildren()

Use Case: Explains how to use RemoveAllChildren() method.

auto doc = MakeObject<Document>(u"input.docx");
 
int32_t nodeCountBefore = doc->GetChildNodes(NodeType::Any, true)->get_Count();
auto start = System::StaticCast<StructuredDocumentTagRangeStart>(doc->get_FirstSection()->get_Body()->GetChild(NodeType::StructuredDocumentTagRangeStart, 0, false));
start->RemoveAllChildren();
 
int32_t nodeCountAfter = doc->GetChildNodes(NodeType::Any, true)->get_Count();

std::cout << nodeCountBefore << '\n' << nodeCountAfter << '\n';

A new public RemoveSelfOnly() method has been added.

/// <summary>
/// Removes this range start and appropriate range end nodes of the structured document tag,
/// but keeps its content inside the document tree.
/// </summary>
public void RemoveSelfOnly()

Use Case: Explains how to use RemoveSelfOnly() method.

auto doc = MakeObject<Document>(u"input.docx");
auto start = System::StaticCast<StructuredDocumentTagRangeStart>(doc->get_FirstSection()->get_Body()->GetChild(NodeType::StructuredDocumentTagRangeStart, 0, false));
start->RemoveSelfOnly();

Removed obsolete PdfSaveOptions.EscapeUri property

This option is not needed anymore because writing of URI to PDF was improved and cases when disabled escaping was required are handled well now.