Aspose.Words for .NET 19.11 Release Notes
Contents
[
Hide
]
This page contains release notes for Aspose.Words for .NET 19.11.
Major Features
- Provided an ability to work with Web Extensions, new classes allow to customize elements and attributes that extend the XML vocabulary for Office Add-ins representation.
- Added an ability to customize the formatting of the horizontal rule shape.
- Improved character spacing calculation when ‘use printer metrics’ option is set.
- Macros support improved.
Full List of Issues Covering all Changes in this Release
| Key | Summary | Category |
|---|---|---|
| WORDSNET-18890 | Consider support ECSDA | New Feature |
| WORDSNET-18182 | Add feature to set properties of horizontal rule | New Feature |
| WORDSNET-19023 | Throw warnings about the presence of JavaScript (or any other unsupported Scripts) in HTML | New Feature |
| WORDSNET-19152 | Support of .NET Core 3.0 in Aspose.Words | New Feature |
| WORDSNET-19197 | Implement EMF compound lines rendering to PDF - DOCX to PDF conversion issue with Shape rendering | New Feature |
| WORDSNET-19280 | Add support for extraction MOL files from OLE object | New Feature |
| WORDSNET-18681 | Support for adding dynamic WebExtension element nodes in Word Document | New Feature |
| WORDSNET-19363 | Implement unified EMF complex paths rendering | New Feature |
| WORDSNET-6035 | Create documentation for using temporary folder on save | Enhancement |
| WORDSNET-10301 | Add feature to edit macros of a document | Enhancement |
| WORDSNET-11177 | Consider adding an ability to read/add/edit/delete macros in documents | Enhancement |
| WORDSNET-13121 | Insert Macro into a Document | Enhancement |
| WORDSNET-19153 | Improve a VBAProject class to be able to read all project content into the document model | Enhancement |
| WORDSNET-19198 | Border of boxes in Shape is changed in output PDF | Enhancement |
| WORDSNET-19345 | Add normalize Istds feature to Document.Cleanup | Bug |
| WORDSNET-19371 | The right offset of the chart is changed after converting to PFG | Bug |
| WORDSNET-19372 | Axis title is set. Right and left offsets are changed after converting to PDF | Bug |
| WORDSNET-19427 | System.ArgumentOutOfRangeException occurs upon comparing documents | Bug |
| WORDSNET-19438 | Range.Bookmarks.Count returns incorrect value | Bug |
| WORDSNET-17906 | Chart rendered to PDF/HTML does not look the same as the original one in DOCX | Bug |
| WORDSNET-19439 | Paragraph alignment is lost when Range.Replace is used with &p | Bug |
| WORDSNET-19308 | Paragraph break size does not match MS Word in Aspose.Words DOCX, PDF output | Bug |
| WORDSNET-19301 | DOCX to PDF - hyphenation not same | Bug |
| WORDSNET-18077 | DOCX to PDF - output chart legend box is bigger | Bug |
| WORDSNET-18118 | DOCX to PDF conversion issue with legend | Bug |
| WORDSNET-19007 | Strikethrough should be rendered over inline picture in compatibility mode | Bug |
| WORDSNET-19303 | Colons on the wrong side of the text after conversion to PDF | Bug |
| WORDSNET-11536 | Table is moved to previous page | Bug |
| WORDSNET-17075 | Word to RTF conversion with absolute positioned textboxes renders incorrectly | Bug |
| WORDSNET-19382 | DOC to DOCX lost fonts | Bug |
| WORDSNET-19027 | Image has wrong size after conversion | Bug |
| WORDSNET-19239 | MHT to PDF FileCorruptedException XMLStreamException | Bug |
| WORDSNET-17869 | Incorrect width of the plot area and the legend after converting to PDF | Bug |
| WORDSNET-17781 | Incorrect rendering of legend markers after converting to PDF | Bug |
| WORDSNET-17816 | MailMerge.Execute does not update the IF field | Bug |
| WORDSNET-19389 | Aspose.Words.FileCorruptedException is thrown while loading DOCX | Bug |
| WORDSNET-19241 | SVG image distorted in document | Bug |
| WORDSNET-19392 | System.OverflowException is thrown while loading DOCX | Bug |
| WORDSNET-17779 | Text of legend items is clipped after converting to PDF | Bug |
| WORDSNET-18947 | DOCX to PDF conversion issue with page number rendering | Bug |
| WORDSNET-19398 | PageCount returns the wrong value and after the UpdatePageLayout it increases | Bug |
| WORDSNET-19187 | VbaModule.SourceCode does not update the VBA code | Bug |
| WORDSNET-19401 | Document.Save throws System.InvalidOperationException | Bug |
| WORDSNET-19271 | Font color changes while Word document is saved as PDF | Bug |
| WORDSNET-19209 | UpdateFields does not calculate SUM inside FORMTEXT | Bug |
| WORDSNET-18973 | Check suspicious code found by PVS studio | Bug |
| WORDSNET-18764 | DOC to PDF conversion issue with flow chart rendering | Bug |
| WORDSNET-18855 | Remove the MailMergeRtlCleanupMode enum | Bug |
| WORDSNET-19396 | On conversion to PDF the code throws NullReferenceException when MemoryOptimization is set to true | Bug |
| WORDSNET-18768 | Incorrect placement of the legend items after converting to PDF | Bug |
| WORDSNET-19306 | Hidden data is displayed on conversion DOC to TIFF | Bug |
| WORDSNET-19304 | After conversion to PDF one more page added, and wrong page number on the first page | Bug |
| WORDSNET-19310 | NumberFormat.FormatCode resets after applying NumberFormat.IsLinkedToSource | Bug |
| WORDSNET-19069 | NullReferenceException when saving DOCX to PDF with MemoryOptimization enabled | Bug |
| WORDSNET-19314 | The issue with the graph’s legends after conversion DOCX to PDF | Bug |
| WORDSNET-19313 | DOC to Fixed page format conversion issue with page header | Bug |
| WORDSNET-19316 | Numbering disappear during appending documents | Bug |
| WORDSNET-19318 | DOC to DOCX lost fonts | Bug |
| WORDSNET-19076 | Text is rendered outside the table’s cell in output PDF | Bug |
| WORDSNET-19324 | Inconsistent behavior of FormatterPal.TryParseInt | Bug |
| WORDSNET-19326 | Table loses conditional formatting for cell | Bug |
| WORDSNET-19327 | Aspose.Words.FileCorruptedException occurs upon loading a DOC | Bug |
| WORDSNET-19339 | BuiltInDocumentProperties.Words returns incorrect words count for Chinese | Bug |
| WORDSNET-19298 | Exception is thrown when updating word page layout | Bug |
| WORDSNET-19341 | Font AltName is not written when Aspose.Words is running on Linux | Bug |
| WORDSNET-19328 | Aspose.Words.FileCorruptedException occurs upon loading a DOC | Bug |
| WORDSNET-19351 | List number does not restart when document is inserted using InsertDocument method | Bug |
| WORDSNET-19353 | Aspose.Words.FileCorruptedException occurs on loading a DOCX file | Bug |
| WORDSNET-19168 | SmartArt to PNG conversion issue with text rendering | Bug |
| WORDSNET-19346 | Font of content control is changed after convesion from DOCX to HTML | Bug |
| WORDSNET-19299 | Tables incorrectly split after UpdatePageLayout | Bug |
| WORDSNET-12684 | Shape’s text position is changed in output PDF | Bug |
| WORDSNET-19384 | Analyze what it takes to work License.SetLicense with .NET Core 2.2 | Bug |
| WORDSNET-13190 | Chinese text moves to next line after conversion from DOCX to PDF | Bug |
| WORDSNET-9076 | Empty spaces appear after conversion from DOC to HTML | Bug |
| WORDSNET-13414 | Table’s rows are moved to previous page in output PDF | Bug |
| WORDSNET-13488 | Google translate shows different result for Aspose.Words generated PDF content | Bug |
| WORDSNET-13053 | Chinese text moves to next lines at each page of TIFF/PDF | Bug |
| WORDSNET-12697 | Cell’s text is truncated after saving DOCX to PDF | Bug |
| WORDSNET-12420 | DOC to PDF conversion issue with image rendering | Bug |
| WORDSNET-12506 | The page layout of Chinese text is not correct in output PDF | Bug |
Public API and Backward Incompatible Changes
This section lists public API changes that were introduced in Aspose.Words 19.11. 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 support for Web extension elements
Following public classes and enums were added.
/// <summary>
/// Represents an add-in task pane object.
/// </summary>
public class TaskPane
{
/// <summary>
/// Creates task pane add-in instance.
/// </summary>
public TaskPane() { }
/// <summary>
/// Specifies the index, enumerating from the outside to the inside, of this task pane among other persisted
/// task panes docked in the same default location.
/// </summary>
public int Row { get; set; }
/// <summary>
/// Specifies the default width value for this task pane instance.
/// </summary>
public double Width { get; set; }
/// <summary>
/// Specifies whether the task pane is locked to the document in the UI and cannot be closed by the user.
/// </summary>
public bool IsLocked { get; set; }
/// <summary>
/// Specifies whether the task pane shows as visible by default when the document opens.
/// </summary>
public bool IsVisible { get; set; }
/// <summary>
/// Specifies the last-docked location of this task pane object.
/// </summary>
/// <dev>In the spec this value represents as string.</dev>
public TaskPaneDockState DockState { get; set; }
/// <summary>
/// Represents an web extension object.
/// </summary>
public WebExtension WebExtension { get; }
}
/// <summary>
/// Specifies a list of persisted task pane objects.
/// </summary>
public class TaskPaneCollection
{
/// <summary>
/// Gets the number of elements contained in the collection.
/// </summary>
public int Count;
/// <summary>
/// Gets or sets an item at the specified index.
/// </summary>
/// <param name="index">Zero-based index of the item.</param>
public T this[int index] { get; set; }
/// <summary>
/// Adds specified item to the collection.
/// </summary>
/// <param name="item">Item for adding.</param>
public void Add(T item);
/// <summary>
/// Removes all elements from the collection.
/// </summary>
public void Clear();
/// <summary>
/// Removes the item at the specified index from the collection.
/// </summary>
/// <param name="index">The zero-based index of the collection item.</param>
public void Remove(int index);
}
/// <summary>
/// Represents a web extension object.
/// </summary>
public class WebExtension
{
/// <summary>
/// Uniquely identifies the web extension instance in the current document.
/// </summary>
public string Id { get; set; }
/// <summary>
/// Specifies whether the user can interact with the web extension or not.
/// </summary>
public bool IsFrozen { get; set; }
/// <summary>
/// Specifies the primary reference to an web extension.
/// </summary>
public WebExtensionReference Reference { get; }
/// <summary>
/// Specifies a list of web extension bindings.
/// </summary>
public WebExtensionBindingCollection Bindings { get; }
/// <summary>
/// Specifies alternate references to a web extension.
/// </summary>
public WebExtensionReferenceCollection AlternateReferences { get; }
/// <summary>
/// Represents a set of web extension custom properties.
/// </summary>
public WebExtensionPropertyCollection Properties { get; }
}
/// <summary>
/// Specifies a binding relationship between a web extension and the data in the document.
/// </summary>
public class WebExtensionBinding
{
/// <summary>
/// Creates web extension binding with specified parameters.
/// </summary>
/// <param name="id">Binding identifier.</param>
/// <param name="bindingType">Binding type.</param>
/// <param name="appRef">Binding key used to map the binding entry in this list with the bound data in the document.</param>
public WebExtensionBinding(string id, WebExtensionBindingType bindingType, string appRef);
/// <summary>
/// Specifies the binding identifier.
/// </summary>
public string Id { get; set; }
/// <summary>
/// Specifies the binding type.
/// </summary>
public WebExtensionBindingType BindingType { get; set; }
/// <summary>
/// Specifies the binding key used to map the binding entry in this list with the bound data in the document.
/// </summary>
/// <dev>It may be, for example, identifier of the SDT.</dev>
public string AppRef { get; set; }
}
/// <summary>
/// Specifies a web extension custom property.
/// </summary>
public class WebExtensionProperty
{
/// <summary>
/// Creates web extension custom property with specified name and value.
/// </summary>
/// <param name="name">Property name.</param>
/// <param name="value">Property value.</param>
public WebExtensionProperty(string name, string value);
/// <summary>
/// Specifies a custom property name
/// </summary>
public string Name { get; set; }
/// <summary>
/// Specifies a custom property value.
/// </summary>
public string Value { get; set; }
}
/// <summary>
/// Represents the reference to a web extension. The reference is used to identify the provider location and version of the
/// extension.
/// </summary>
public class WebExtensionReference
{
/// <summary>
/// Creates instance of the reference to a web extension.
/// </summary>
public WebExtensionReference();
/// <summary>
/// Identifier associated with the web extension within a catalog provider.
/// </summary>
public string Id { get; set; }
/// <summary>
/// Specifies the version of the web extension.
/// </summary>
public string Version { get; set; }
/// <summary>
/// Specifies the instance of the marketplace where the web extension is stored.
/// </summary>
public string Store { get; set; }
/// <summary>
/// Specifies the type of marketplace.
/// </summary>
public WebExtensionStoreType StoreType { get; set; }
}
/// <summary>
/// Specifies a list of web extension bindings.
/// </summary>
public class WebExtensionBindingCollection
{
/// <summary>
/// Gets the number of elements contained in the collection.
/// </summary>
public int Count { get; }
/// <summary>
/// Gets or sets an item at the specified index.
/// </summary>
/// <param name="index">Zero-based index of the item.</param>
public T this[int index] { get; set; }
/// <summary>
/// Adds specified item to the collection.
/// </summary>
/// <param name="item">Item for adding.</param>
public void Add(T item);
/// <summary>
/// Removes all elements from the collection.
/// </summary>
public void Clear();
/// <summary>
/// Removes the item at the specified index from the collection.
/// </summary>
/// <param name="index">The zero-based index of the collection item.</param>
public void Remove(int index);
}
/// <summary>
/// Specifies a set of web extension custom properties.
/// </summary>
public class WebExtensionPropertyCollection
{
/// <summary>
/// Gets the number of elements contained in the collection.
/// </summary>
public int Count { get; }
/// <summary>
/// Gets or sets an item at the specified index.
/// </summary>
/// <param name="index">Zero-based index of the item.</param>
public T this[int index] { get; set; }
/// <summary>
/// Adds specified item to the collection.
/// </summary>
/// <param name="item">Item for adding.</param>
public void Add(T item);
/// <summary>
/// Removes all elements from the collection.
/// </summary>
public void Clear();
/// <summary>
/// Removes the item at the specified index from the collection.
/// </summary>
/// <param name="index">The zero-based index of the collection item.</param>
public void Remove(int index);
}
/// <summary>
/// Specifies a list of web extension references.
/// </summary>
public class WebExtensionReferenceCollection
{
/// <summary>
/// Gets the number of elements contained in the collection.
/// </summary>
public int Count { get; }
/// <summary>
/// Gets or sets an item at the specified index.
/// </summary>
/// <param name="index">Zero-based index of the item.</param>
public T this[int index] { get; set; }
/// <summary>
/// Adds specified item to the collection.
/// </summary>
/// <param name="item">Item for adding.</param>
public void Add(T item);
/// <summary>
/// Removes all elements from the collection.
/// </summary>
public void Clear();
/// <summary>
/// Removes the item at the specified index from the collection.
/// </summary>
/// <param name="index">The zero-based index of the collection item.</param>
public void Remove(int index);
}
/// <summary>
/// Enumerates available locations of task pane object.
/// </summary>
public enum TaskPaneDockState
{
Right,
Left
}
/// <summary>
/// Enumerates available types of binding between a web extension and the data in the document.
/// </summary>
public enum WebExtensionBindingType
{
/// <summary>
/// Tabular data without a header row.
/// </summary>
Matrix,
/// <summary>
/// Tabular data with a header row.
/// </summary>
Table,
/// <summary>
/// Plain text.
/// </summary>
Text,
Default = Matrix
}
/// <summary>
/// Enumerates available types of a web extension store.
/// </summary>
public enum WebExtensionStoreType
{
SPCatalog,
OMEX,
SPApp,
Exchange,
FileSystem,
Registry,
ExCatalog,
Default = SPCatalog
}
Typical Use Case.
Document doc = new Document();
TaskPane taskPane = new TaskPane();
doc.WebExtensionTaskPanes.Add(taskPane);
taskPane.DockState = TaskPaneDockState.Right;
taskPane.IsVisible = true;
taskPane.Width = 300;
taskPane.WebExtension.Reference.Id = "wa102923726";
taskPane.WebExtension.Reference.Version = "1.0.0.0";
taskPane.WebExtension.Reference.StoreType = WebExtensionStoreType.OMEX;
taskPane.WebExtension.Reference.Store = "th-TH";
taskPane.WebExtension.Properties.Add(new WebExtensionProperty("mailchimpCampaign", "mailchimpCampaign"));
taskPane.WebExtension.Bindings.Add(new WebExtensionBinding("UnnamedBinding_0_1506535429545", WebExtensionBindingType.Text, "194740422"));
Horizontal rule formatting
Related issue: WORDSNET-18182
Added new public property Shape.HorizontalRuleFormat
/// <summary>
/// Provides access to the properties of the horizontal rule shape.
/// For a shape that is not a horizontal rule, returns null.
/// </summary>
public HorizontalRuleFormat HorizontalRuleFormat
Added new public class HorizontalRuleFormat HorizontalRuleFormat class allows to fully customize the formatting of the horizontal rule. This class can only be obtained through the Shape.HorizontRuleFormat property.
/// <summary>
/// Represents horizontal rule formatting.
/// </summary>
public class HorizontalRuleFormat
{
/// <summary>
/// Gets or sets the length of the specified horizontal rule expressed as a percentage of the window width.
/// </summary>
/// <remarks>
/// <p>Valid values range from 1 to 100 inclusive.</p>
/// <p>The default value is 100.</p>
/// </remarks>
/// <exception cref="ArgumentOutOfRangeException">
/// Throws when argument was out of the range of valid values.
/// </exception>
public double WidthPercent
{
get; set;
}
/// <summary>
/// Gets or sets the height of the horizontal rule.
/// </summary>
/// <remarks>
/// <p>This is a shortcut to the <see cref="Aspose.Words.Drawing.ShapeBase.Height"/> property.</p>
/// <p>Valid values range from 0 to 1584 inclusive.</p>
/// <p>The default value is 1.5.</p>
/// </remarks>
/// <exception cref="ArgumentOutOfRangeException">
/// Throws when argument was out of the range of valid values.
/// </exception>
public double Height
{
get; set;
}
/// <summary>
/// Indicates the presence of 3D shading for the horizontal rule.
/// If true, then the horizontal rule is without 3D shading and solid color is used.
/// </summary>
/// <remarks>
/// <p>The default value is false.</p>
/// </remarks>
public bool NoShade
{
get; set;
}
/// <summary>
/// Gets or sets the brush color that fills the horizontal rule.
/// </summary>
/// <remarks>
/// <p>This is a shortcut to the <see cref="Aspose.Words.Drawing.Fill.Color"/> property.</p>
/// <p>The default value is
/// <ms><see cref="System.Drawing.Color.Gray"/>.</ms>
/// <java><see javaref="T:java.awt.Color.GRAY"/>.</java>
/// </p>
/// </remarks>
public Color Color
{
get; set;
}
/// <summary>
/// Gets or sets the alignment of the horizontal rule.
/// </summary>
/// <remarks>
/// <p>The default value is <see cref="HorizontalRuleAlignment.Left"/>.</p>
/// </remarks>
public HorizontalRuleAlignment Alignment
{
get; set;
}
}
Added public enum HorizontalRuleAlignment
/// <summary>
/// Represents the alignment for the specified horizontal rule.
/// </summary>
public enum HorizontalRuleAlignment
Use Case:
DocumentBuilder builder = new DocumentBuilder();
Shape shape = builder.InsertHorizontalRule();
HorizontalRuleFormat horizontalRuleFormat = shape.HorizontalRuleFormat;
horizontalRuleFormat.Alignment = HorizontalRuleAlignment.Center;
horizontalRuleFormat.WidthPercent = 70;
horizontalRuleFormat.Height = 3;
horizontalRuleFormat.Color = Color.Blue;
horizontalRuleFormat.NoShade = true;
builder.Document.Save("HorizontalRuleFormat.docx");
Macros support improved
Related issue: WORDSNET-19153
Added a new public setter for a Document.VbaProject
/// <summary>
/// Gets or sets a <see cref="VbaProject" />.
/// </summary>
public VbaProject VbaProject
Added a new public constructor for a VbaProject class.
/// <summary>
/// Creates a blank VbaProject.
/// </summary>
public VbaProject()
Added a new public setter for a VbaProject.Name
/// <summary>
/// Gets or sets VBA project name.
/// </summary>
public string Name
Added a new public getter for a VbaProject.CodePage
/// <summary>
/// Returns the VBA project’s code page.
/// </summary>
public int CodePage
Added a new public constructor for a VbaModule class.
/// <summary>
/// Creates an empty module.
/// </summary>
public VbaModule()
Added a new public setter for a VbaModule.Name
/// <summary>
/// Gets or sets VBA project module name.
/// </summary>
public string Name
Added a new public property VbaModule.Type
/// <summary>
/// Specifies whether the module is a procedural module, document module, class module, or designer module.
/// </summary>
public VbaModuleType Type
Added a new public void VbaModuleCollection.Add(VbaModule vbaModule)
/// <summary>
/// Adds a module to the collection.
/// </summary>
public void Add(VbaModule vbaModule)
Added a new public void VbaModuleCollection.Remove(VbaModule vbaModule)
/// <summary>
/// Removes the specified module from the collection.
/// </summary>
/// <param name="module">The module to remove.</param>
public void Remove(VbaModule module)
Added ability to retrieve a module from the VbaModuleCollection by name.
/// <summary>
/// Retrieves a <see cref="VbaModule"/> object by name, or Null if not found.
/// </summary>
public VbaModule this[string name]
Added a new public property VbaModuleCollection.Count
/// <summary>
/// Returns the number of VBA modules in the collection.
/// </summary>
public int Count
Added public enums for specifying a VbaModule type.
/// <summary>
/// Specifies the type of a model in a VBA project.
/// </summary>
public enum VbaModuleType
{
/// <summary>
/// Specifies a module that extends a document module.
/// </summary>
DocumentModule,
/// <summary>
/// Specifies a procedural module.
/// </summary>
ProceduralModule,
/// <summary>
/// Specifies a class module.
/// </summary>
ClassModule,
/// <summary>
/// Specifies a designer module.
/// </summary>
DesignerModule
}
Use Case: Explains how to create a VbaProject from a scratch, create a VbaModules from a scratch and add it to the project.
Document doc = new Document();
// Create a new VBA project.
VbaProject project = new VbaProject();
project.Name = "AsposeProject";
doc.VbaProject = project;
// Create a new module and specify a macro source code.
VbaModule module = new VbaModule();
module.Name = "AsposeModule";
module.Type = VbaModuleType.ProceduralModule;
module.SourceCode = "New source code";
// Add module to the VBA project.
doc.VbaProject.Modules.Add(module);
Obsolete enum Aspose.Words.MailMerging.MailMergeRtlCleanupMode was removed
Obsolete enum Aspose.Words.MailMerging.MailMergeRtlCleanupMode was removed.