Aspose.Words for .NET是一种高级Word文档处理API，用于执行各种文档管理和操作任务。API支持生成，修改，转换，呈现和打印文档，而无需在跨平台应用程序中直接使用Microsoft Word。通过集成API，开发人员可以执行的一些基本任务，例如设计具有标准邮件合并字段的全功能Microsoft Word报告，几种常用格式之间的可靠转换，页面的高保真渲染，所有文档元素的格式化等等。
Aspose.Words for .NET更新至v19.7，为Markdown格式实现基本的读写器，同时实现了检测SmartArt形状的功能！接下来我们给大家介绍一下新版中引入的公告API的更改，并用示例实际阐述一下。>>下载Aspose.Words for .NET最新试用版
Aspose.Words 19.7公共API的更改
▲添加了属性Revision.Group
在Revision类中添加了以下新属性：
// Gets the revision group. Returns null if the revision does not belong to any group.
/ Revision has no group if revision type is RevisionType.StyleDefinitionChange or
/// if the revision is not longer exist in document context (accepted/rejected).
///public RevisionGroup Group
|
使用案例：
Document doc =
new
Document(@
"source.docx"
);
foreach (Revision revision
in
doc.Revisions)
{
string groupText = revision.Group !=
null
?
"Revision group text: "
+ revision.Group.Text
:
"Revision has no group"
;
Console.WriteLine(
"Type: "
+ revision.RevisionType);
Console.WriteLine(
"Author: "
+ revision.Author);
Console.WriteLine(
"Date: "
+ revision.DateTime);
Console.WriteLine(
"Revision text: "
+ revision.ParentNode.ToString(SaveFormat.Text));
Console.WriteLine(groupText);
}
|
▲为Markdown功能实现了基本的读写器
暂时支持以下Markdown功能：
- 标题
- 成批引用
- 横向规则
- 黑体强调
- 斜体强调
增加了新的公开枚举：
LoadFormat.Markdown
SaveFormat.Markdown
FileFormat.Markdown
|
添加了新的TxtSaveOptionsBase类：
// The base class for specifying additional options when saving a document into a text based formats.
///public abstract class TxtSaveOptionsBase : SaveOptions
|
一些成员从TxtSaveOptions类移动到TxtSaveOptionsBase类：
// Specifies the encoding to use when exporting in text formats.
/// Default value isEncoding.UTF8'UTF-8' Charset.
///public Encoding Encoding
// Specifies the string to use as a paragraph break when exporting in text formats.
/The default value is.///public string ParagraphBreak
// Specifies whether the program should attempt to preserve layout of tables when saving in the plain text format.
/// The default value is false.
///public bool PreserveTableLayout
//Allows to specify whether the page breaks should be preserved during export.///The default value is false./ The property affects only page breaks that are inserted explicitly into a document.
/// It is not related to page breaks that MS Word automatically inserts at the end of each page.
///public bool ForcePageBreaks
// Specifies the way headers and footers are exported to the text formats.
/// Default value is.
///public TxtExportHeadersFootersMode ExportHeadersFootersMode
|
功能的实现主要遵循CommonMark规范。在AW模型中，Markdown功能表示为相应的样式或直接格式。因此，粗体和斜体表示为Font.Bold和Font.Italic。标题是标题1 - 标题6样式的段落。引号是样式名称中带有“引用”的段落。HorizontalRule是具有HorizontalRule形状的段落。
使用案例1：如何生成以下Markdown文档的重点：
Markdown treats asterisks (*) and underscores (_) as indicators of emphasis. You can write **bold** or *italic* text. You can also write ***BoldItalic***text.
DocumentBuilder builder =
new
DocumentBuilder(
new
Document());
builder.Writeln(
"Markdown treats asterisks (*) and underscores (_) as indicators of emphasis."
);
builder.Write(
"You can write "
);
builder.Font.Bold =
true
;
builder.Write(
"bold"
);
builder.Font.Bold =
false
;
builder.Write(
" or "
);
builder.Font.Italic =
true
;
builder.Write(
"italic"
);
builder.Font.Italic =
false
;
builder.Writeln(
" text. "
);
builder.Write(
"You can also write "
);
builder.Font.Bold =
true
;
builder.Font.Italic =
true
;
builder.Write(
"BoldItalic"
);
builder.Font.Bold =
false
;
builder.Font.Italic =
false
;
builder.Write(
"text."
);
builder.Document.Save(
"EmphasesExample.md"
);
|
使用案例2：如何使用标题生成以下Markdown文档：
The following produces headings: # Heading1 ## Heading2 ### Heading3 #### Heading4 ##### Heading5 ###### Heading6 # **Bold Heading1**
Document doc =
new
Document();
DocumentBuilder builder =
new
DocumentBuilder(doc);
// By default Heading styles in Word may have bold and italic formatting.
// If we do not want text to be emphasized, set these properties explicitly to false.
builder.Font.Bold =
false
;
builder.Font.Italic =
false
;
builder.Writeln(
"The following produces headings:"
);
builder.ParagraphFormat.Style = doc.Styles[
"Heading 1"
];
builder.Writeln(
"Heading1"
);
builder.ParagraphFormat.Style = doc.Styles[
"Heading 2"
];
builder.Writeln(
"Heading2"
);
builder.ParagraphFormat.Style = doc.Styles[
"Heading 3"
];
builder.Writeln(
"Heading3"
);
builder.ParagraphFormat.Style = doc.Styles[
"Heading 4"
];
builder.Writeln(
"Heading4"
);
builder.ParagraphFormat.Style = doc.Styles[
"Heading 5"
];
builder.Writeln(
"Heading5"
);
builder.ParagraphFormat.Style = doc.Styles[
"Heading 6"
];
builder.Writeln(
"Heading6"
);
// Note, emphases are also allowed inside Headings:
builder.Font.Bold =
true
;
builder.ParagraphFormat.Style = doc.Styles[
"Heading 1"
];
builder.Writeln(
"Bold Heading1"
);
doc.Save(
"HeadingsExample.md"
);
|
使用案例3：如何使用块引号生成以下Markdown文档：
We support blockquotes in Markdown: >*Lorem* >*ipsum* The quotes can be of any level and can be nested: >>>Quote level 3 >>>>Nested quote level 4 > >*Back to first level* > ### Headings are allowed inside Quotes
Document doc =
new
Document();
DocumentBuilder builder =
new
DocumentBuilder(doc);
builder.Writeln(
"We support blockquotes in Markdown:"
);
builder.ParagraphFormat.Style = doc.Styles[
"Quote"
];
builder.Writeln(
"Lorem"
);
builder.Writeln(
"ipsum"
);
builder.ParagraphFormat.Style = doc.Styles[
"Normal"
];
builder.Writeln(
"The quotes can be of any level and can be nested:"
);
Style quoteLevel3 = doc.Styles.Add(StyleType.Paragraph,
"Quote2"
);
builder.ParagraphFormat.Style = quoteLevel3;
builder.Writeln(
"Quote level 3"
);
Style quoteLevel4 = doc.Styles.Add(StyleType.Paragraph,
"Quote3"
);
builder.ParagraphFormat.Style = quoteLevel4;
builder.Writeln(
"Nested quote level 4"
);
builder.ParagraphFormat.Style = doc.Styles[
"Quote"
];
builder.Writeln();
builder.Writeln(
"Back to first level"
);
Style quoteLevel1WithHeading = doc.Styles.Add(StyleType.Paragraph,
"Quote Heading 3"
);
builder.ParagraphFormat.Style = quoteLevel1WithHeading;
builder.Write(
"Headings are allowed inside Quotes"
);
doc.Save(
"QuotesExample.md"
);
|
使用案例4：如何使用水平规则生成以下Markdown文档：
We support Horizontal rules (Thematic breaks) in Markdown: -----
DocumentBuilder builder =
new
DocumentBuilder(
new
Document());
builder.Writeln(
"We support Horizontal rules (Thematic breaks) in Markdown:"
);
builder.InsertHorizontalRule();
builder.Document.Save(
"HorizontalRuleExample.md"
);
|
使用案例5：如何阅读Markdown文档：
// This is Markdown document that was produced in example of UC3.
Document doc =
new
Document(
"QuotesExample.md"
);
// Let's remove Heading formatting from a Quote in the very last paragraph.
Paragraph paragraph = doc.FirstSection.Body.LastParagraph;
paragraph.ParagraphFormat.Style = doc.Styles[
"Quote"
];
doc.Save(
"QuotesModifiedExample.md"
);
|
▲实现了检测SmartArt形状的功能
将以下新属性添加到Shape类：
// Returns true if this Shape has a SmartArt object.
///public bool HasSmartArt
|
使用案例：在文档中使用SmartArt计算多个形状。
Document doc =
new
Document(@
"input.docx"
);
int
count =
0
;
foreach (Shape shape
in
doc.GetChildNodes(NodeType.Shape,
true
))
{
if
(shape.HasSmartArt)
count++;
}
Console.WriteLine(
"The document has {0} shapes with SmartArt."
, count);
|
▲实现了对OpenType字体的支持和对Kerning功能的支持
新的公共属性TextShaperFactory已添加到LayoutOptions类。
public ITextShaperFactory TextShaperFactory { get; set; }
应通过单独的nuget-packages提供ITextShaperFactory的实现。具体实现应创建一个表示字体的文本整形器，并计算文本的整形信息。下面是一个用法示例：
public
void
Test()
{
// Open a document
Document doc =
new
Document(
"OpenType.Document.docx"
);
// When text shaper factory is set, layout starts to use OpenType features.
// An Instance property returns static BasicTextShaperCache object wrapping HarfBuzzTextShaperFactory
doc.LayoutOptions.TextShaperFactory = Aspose.Words.Shaping.HarfBuzz.HarfBuzzTextShaperFactory.Instance;
// Render the document to PDF format
doc.Save(
"OpenType.Document.pdf"
);
}
|
▲WORDSNET-11297 - 实现了用于处理链接文本框的公共API
添加了一个用于从文本框中获取父形状的公共属性，以允许客户从链接的TextBox中查找链接的Shape。
// Determines whether this TextBox can be linked to the target Textbox.
///public bool IsValidLinkTarget(TextBox target)
{
}
// Returns or sets a TextBox that represents the next TextBox in a sequence of shapes.
///public TextBox Next
{
get
;
set
;
}
// Returns a TextBox that represents the previous TextBox in a sequence of shapes.
///public TextBox Previous
{
get
;
}
// Breaks the forward link for the specified TextBox, if such a link exists.
/ BreakForwardLink() doesn't break all other links in the current sequence of shapes.
/// For example: 1-2-3-4 sequence and BreakForwardLink at the 2-nd textbox will create
/// two sequences 1-2, 3-4.
///public void BreakForwardLink()
{
}
// Gets a parent shape for the TextBox.
///public Shape Parent
{
get
{
return
mParent; }
}
|
使用案例：创建从shape1.TextBox到shape2.TextBox的链接。
TextBox textBox1 = shape1.TextBox;
TextBox textBox2 = shape2.TextBox;
if
(textBox1.IsValidLinkTarget(textBox2))
textBox1.Next = textBox2;
|
使用案例：检查shape.TextBox是序列的头部，尾部还是中间。
TextBox textBox = shape.TextBox;
if
((textBox.Next !=
null
) && (textBox.Previous ==
null
))
{
//The head of the sequence.
}
if
((textBox.Next !=
null
) && (textBox.Previous !=
null
))
{
//The Middle of the sequence.
}
if
((textBox.Next ==
null
) && (textBox.Previous !=
null
))
{
//The Tail of the sequence.
}
|
使用案例：破坏shape.TextBox的链接。
TextBox textBox = shape.TextBox;
// Break a forward link
textBox.BreakForwardLink();
// Break a forward link by setting a null
textBox.Next =
null
;
// Break a link, which leads to this textbox
if
(textBox.Previous !=
null
)
textBox.Previous.BreakForwardLink();
|
ASPOSE技术交流QQ群（642018183）已开通，各类资源及时分享，欢迎交流讨论！
1万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
