设置input不能为空_支持显式设置编码Charset和BOM！Java版Aspose.Words v20.7发布

随着.NET版Aspose.Words for .Net v20.7的发布，Java版也随之更新，除了一些通用功能外，也独有新改善。

主要特点如下：

• 通过TxtSaveOptions.setEncoding(Charset)显式设置编码Charset和BOM。
• 添加了新节点以处理多节结构化文档标签。
• 添加了一个新的公共属性MailMerge.RetainFirstSectionStart。
• RevisionOptions类扩展了新的属性。
• 改进了SmartArt冷渲染的性能。

>>你可以点击文末“了解更多”下载Aspose.Words for Java v20.7测试体验

具体更新内容

• WORDSJAVA-2327 通过TxtSaveOptions.setEncoding(Charset)显式设置编码Charset和BOM的用户选项 新功能
• WORDSJAVA-2416 更新第三方软件版本，许可协议等。 新功能
• WORDSNET-9500 国际字符(泰米尔语)不能正确地从MHTML转换为PDF 新功能
• WORDSNET-7150 SDT控件在打开/保存过程中丢失 新功能
• WORDSNET-9501 国际字符(泰卢固语)未正确从MHTML转换为PDF 新功能
• WORDSNET-5713 包含分节符的StructuredDocumentTag在加载时丢失 新功能
• WORDSNET-20589 PDF到DOCX-脚注 新功能
• WORDSNET-20480 提供属性以在邮件合并期间启用“严格MS Word行为合规性” 新功能
• WORDSNET-9908 通过分节符保留RichText内容控件 新功能
• WORDSNET-6773 设置AllowBreakAcrossPages = False时截断大于页面大小的行内容 增强功能
• WORDSNET-20415 通过轨道更改将DOCX转换为PDF时保持修订条 增强功能
• WORDSNET-18609 一行移至PDF的上一页 增强功能

公共API更改

①添加了新的公共属性MailMerge.RetainFirstSectionStart

///

/// Gets or sets a value indicating whether the of the first document section and its copies for subsequent data source rows

/// are retained during mail merge or updated according to MS Word behaviour.

///

///

/// The default value is true.

///

publicboolRetainFirstSectionStart {get;set; }

用例：

Document document = new Document(path);document.MailMerge.RetainFirstSectionStart = false;document.MailMerge.Execute(dataSource);

②添加新值到公共枚举WarningSource

...

///

/// Module that reads/writes Markdown files.

///

Markdown

用例：

Document doc = TestUtil.Open("input.docx");  WarningInfoCollection warnings = new WarningInfoCollection();doc.WarningCallback = warnings;doc.Save("output.md");  foreach (WarningInfo warningInfo in warnings){    if (warningInfo.Source == WarningSource.Markdown)        Console.WriteLine(warningInfo.Description);}

③在RevisionOptions中添加了公共属性MeasurementUnit

///

/// Allows to specify the measurement unit for revision comments.

/// Default value for this property is

///

public MeasurementUnits MeasurementUnit

另外，添加了新的公共枚举：

///

/// Specifies a the unit of measurement.

///

public enum MeasurementUnits

{

///

/// Inches.

///

Inches = 0,

///

/// Centimeters.

///

Centimeters = 1,

///

/// Millimeters.

///

Millimeters = 2,

///

/// Points.

///

Points = 3,

///

/// Picas (commonly used in traditional typewriter font spacing).

///

Picas = 4

}

用例：

Document doc = new Document(myDir +"Input.docx");  doc.LayoutOptions.RevisionOptions.MeasurementUnit = MeasurementUnits.Inches;doc.LayoutOptions.RevisionOptions.ShowInBalloons = ShowInBalloons.FormatAndDelete;doc.LayoutOptions.ShowComments = true;  doc.Save(myDir +"Output.pdf");

④在RevisionOptions中添加了公共属性RevisionBarsPosition

///

/// Gets or sets rendering position of revision bars.

/// Default value is .

///

/// Values of and

/// are not allowed and will cause .

用例：

Document doc = new Document(myDir +"Input.docx");  //Renders revision bars on the right side of a page.doc.LayoutOptions.RevisionOptions.RevisionBarsPosition = HorizontalAlignment.Right;doc.Save(myDir +"Output.pdf");

⑤添加了两个新节点来处理多节的结构化文档标签

public class StructuredDocumentTagRangeStart : Node

{

///

/// Gets the type of this node.

///

public NodeType NodeType { get ; }

///

/// Gets the level at which this SDT range start occurs in the document tree.

///

public MarkupLevel Level { get ; }

///

/// Gets type of this Structured document tag.

///

public SdtType SdtType { get ; }

///

/// Specifies a unique read-only persistent numerical Id for this SDT.

///

public int Id { get ; }

///

/// When set to true, this property will prohibit a user from deleting this SDT.

///

public bool LockContentControl { get ; }

///

/// When set to true, this property will prohibit a user from editing the contents of this SDT.

///

public bool LockContents { get ; }

///

/// Specifies whether the content of this SDT shall be interpreted to contain placeholder text

/// (as opposed to regular text contents within the SDT).

///

public bool IsShowingPlaceholderText { get ; }

///

/// Specifies a tag associated with the current SDT node.

///

public string Tag { get ; }

///

/// Specifies the friendly name associated with this SDT.

///

public string Title { get ; }

///

/// Specifies end of range if the StructuredDocumentTag is a ranged structured document tag.

///

public StructuredDocumentTagRangeEnd RangeEnd { get ; }

}

public class StructuredDocumentTagRangeEnd : Node

{

///

/// Gets the type of this node.

///

public NodeType NodeType { get ; }

///

/// Specifies a unique read-only persistent numerical Id for this structured document tag node.

/// Corresponding range start node has the same Id.

///

public int Id { get ; }

}

用例：

Document doc = new Document("document containing multi-section SDT");Listtags =                doc.GetChildNodes(NodeType.StructuredDocumentTagRangeStart, true).ToList();  foreach(StructuredDocumentTagRangeStart tag in tags)    Console.WriteLine(tag.Title);