Aspose.Words使用教程之插入文档元素(三)

1.插入一个字段：

Microsoft Word文档字段由一段字段代码和字段结果组成，这字段代码就像一个公式而字段结果就是这个公式产生的价值。字段代码也可能包括额外的指令来执行特定的操作的field switches 。

你可以切换显示字段代码和使用快捷键Alt+F9得到Microsoft Word文档结果，领域代码出现在花括号({ })之间。

使用({{DocumentBuilder。InsertField}})来创建文档中的字段，需要指定一个字段类型,字段代码和字段值，如果不确定特定领域代码语法,那首先创建在Microsoft Word创建字段然后切换来看它的字段代码。

Example

使用DocumentBuilder合并一个字段到文档中：

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.InsertField(@"MERGEFIELD MyFieldName \* MERGEFORMAT");

2.插入一个表单字段：

表单字段是一个特殊的允许与用户交互的词字段，在Microsoft Word中表单字段包括文本框,组合框和复选框。

DocumentBuilder提供了特殊的方法来将每种类型的表单字段插入到文档:[{{DocumentBuilder.InsertTextInput}}]、[{{DocumentBuilder.InsertCheckBox}}]以及[{{DocumentBuilder.InsertComboBox}}]，注意,如果您为你的表单字段指定一个名称,那么会用相同的名称自动创建一个书签。

（1）插入文本输入：

使用DocumentBuilder.InsertTextInput向文档插入一个文本框

Example

如何向文档插入一个文本输入表单字段。

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.InsertTextInput("TextInput", TextFormFieldType.Regular, "", "Hello", 0);

（2）插入一个复选框

Example

如何向文档插入一个复选框：

Document doc = new Document();

DocumentBuilder builder = new DocumentBuilder(doc);

builder.InsertCheckBox("CheckBox", true, 0);

（3）插入一个组合框

调用DocumentBuilder.InsertComboBox向文档插入一个组合框。

Example

如何将一个组合框表单字段插入文档。

Document doc = new Document();

DocumentBuilder builder = new DocumentBuilder(doc);

string[] items = { "One", "Two", "Three" };

3.插入HTML

你可以很容易地插入包含一个HTML片段或整个HTML文档的HTML字符串到文档里，只需要传递这字符串到DocumentBuilder.InsertHtmlmethod。

一个有用的实现方法是将一个HTML字符串存储在一个数据库,并将它插入到文档在邮件合并的格式化添加的内容,而不是构建文档构建器的使用各种方法。

Example

使用DocumentBuilder向文档添加HTML。

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.InsertHtml(
    "<P align='right'>Paragraph right</P>" +
    "<b>Implicit paragraph left</b>" +
    "<div align='center'>Div center</div>" +
    "<h1 align='left'>Heading 1 left.</h1>");
doc.Save(MyDir + "DocumentBuilder.InsertHtml Out.doc");