Aspose.words编程指南之DocumentBuilder二
来源:互联网 发布:免费广告录音软件 编辑:程序博客网 时间:2024/05/16 07:05
转载请注明:
http://blog.csdn.net/sinat_30276961/article/details/48291547
上一篇Aspose.words编程指南之DocumentBuilder一有讲到Aspose.words生成文档的一个核心帮助类:DocumentBuilder。介绍了它的作用,并重点讲解了插入元素功能。本篇将延续上篇的内容,继续讲解DocumentBuilder。
插入元素
插入书签
通过DocumentBuidler插入书签,是一件很轻松的事。我们可以把它的过程分三步:
1.DocumentBuilder.StartBookmark
2.插入内容
3.DocumentBuilder.EndBookmark
书签可以覆盖,并且可以跨度很大。要创建一个书签,你需要调用StartBookmark和EndBookmark,并且两者设置的名称一致。
// 下划线不设置 font.setUnderline(Underline.NONE); // 颜色更改 font.setColor(Color.GREEN); font.setSize(12); // inline image builder.insertImage(bitmap,100,150); // floating image// builder.insertImage(bitmap,// RelativeHorizontalPosition.MARGIN,// 100,// RelativeVerticalPosition.MARGIN,// 100,// 100,// 150,// WrapType.NONE); // bookmark builder.startBookmark("firstBookmark"); builder.writeln("My first bookmark"); builder.endBookmark("firstBookmark");
因为先前一直没有把下划线给设掉,发现很难看,所以在插入图片开始把它设置掉。这里需要注意的是,设置格式属性要在DocumentBuilder.moveToXXX方法调用之后调用,否则会失效。
下图就是执行的效果:
我们再来看看它的DOM树:
注意到没,图片、bookmarkStart和bookmark内容放在同一个paragraph,而bookmarkEnd放到了另一个paragraph。如果你有细致的看过上一篇,那么应该是知道的,原因就在于bookmark插入的内容是通过writeln。这个会附带插入一个paragraph break,所以就直接结束了一个paragraph,然后另起一个新的paragraph。
如果改成builder.write(“My first bookmark”),DOM树是这样的:
而且它的显示方式也变了:
产生这种变化的原因其实不难想到,区别就在于一个是writeln,一个是write。前者在字符串结尾马上加上了’\n’,而后者没有。也就是说,前者相当于直接回车了,而后者是Aspose.words给你加的,它在一段的末尾加上了’\n’,自然文字就被拉长了。
插入域
域有两部分组成:field code和field result。field code就像是一个公式,而field result就像是一个值。
要插入一个域,通过调用DocumentBuilder.InsertField。如果你不清楚怎么写field code,你可以通过office word或者WPS插入一个域,然后 Alt+F9查看它的field code。
Document doc = new Document();DocumentBuilder builder = new DocumentBuilder(doc);builder.insertField("MERGEFIELD $MyFieldName \\* MERGEFORMAT");
插入form field
form field是一种特殊的域,它可以允许用户与其进行交互。在office里,form field包含文本框、联合框和勾选框。需要注意的是,你指定了form field的名称,就会自动生成相同名称的bookmark。
针对这几种框,DocumentBuilder提供了各自独立的方法:DocumentBuilder.InsertTextInput, DocumentBuilder.InsertCheckBox和DocumentBuilder.InsertComboBox。
插入textinput
如下代码是插入一个文本框的form field示例:
Document doc = new Document();DocumentBuilder builder = new DocumentBuilder(doc);builder.insertTextInput("TextInput", TextFormFieldType.REGULAR, "", "Hello", 0);
插入checkbox
如下代码是插入一个勾选框的form field示例:
Document doc = new Document();DocumentBuilder builder = new DocumentBuilder(doc);builder.insertCheckBox("CheckBox", true, 0);
插入Combobox
如下代码是插入一个联合框的form field示例:
Document doc = new Document();DocumentBuilder builder = new DocumentBuilder(doc);String[] items = {"One", "Two", "Three"};builder.insertComboBox("DropDown", items, 0);
如下图,是这三个的展示效果:
它的DOM树:
可以看到,的确同时生成了相同名称的bookmark。
插入html
通过DocumentBuilder.InsertHtml,你可以很轻松的插入一段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(getMyDir() + "DocumentBuilder.InsertHtml Out.doc");
如下图所示:
插入链接
通过DocumentBuilder.InsertHyperlink插入一个链接。它内部是调用DocumentBuilder.InsertField。
需要注意的是,你必须设置一下font,比方说下划线。
Document doc = new Document();DocumentBuilder builder = new DocumentBuilder(doc);builder.write("Please make sure to visit ");// Specify font formatting for the hyperlink.builder.getFont().setColor(Color.YELLOW);builder.getFont().setUnderline(Underline.SINGLE);// Insert the link.builder.insertHyperlink("Aspose Website", "http://www.aspose.com", false);// Revert to default formatting.builder.getFont().clearFormatting();builder.write(" for more information.");doc.save(getMyDir() + "DocumentBuilder.InsertHyperlink Out.doc");
结果如下图:
因为在builder.write(” for more information.”)之前调用了builder.getFont().clearFormatting(),所以font的格式恢复到默认值了。
关于DocumentBuilder的讲解就告一段落了。接下去,会讲解怎么使用模板来快速创建文档,感兴趣的朋友请点击Aspose.words Mail Merge初识。
- Aspose.words编程指南之DocumentBuilder二
- Aspose.words编程指南之DocumentBuilder一
- Aspose系列(一) Aspose Words-->DocumentBuilder
- Aspose.words编程指南之Working with Document
- Aspose.words编程指南之DOM树结构初识,Node类继承关系及说明
- Aspose.words编程指南之DOM树再识,各层结构之间的关系
- Aspose.words之插入水印
- Aspose.words之IReplacingCallback接口的应用
- Aspose.Words使用教程之表的合并与拆分
- Aspose.Words使用教程之插入文档元素(三)
- Aspose.Words使用教程之从零创建OOXML图表
- Aspose.Words使用教程之如何重命名合并字段
- Aspose.Words使用教程之如何使用ChartDataLabel
- Aspose.words Mail Merge之Region Mail merge
- Aspose.words Mail Merge之Nest Mail merge
- Aspose.words介绍
- Aspose.Words生成报告
- 如何破解aspose.words
- UIKit各类Object继承关系
- 玩转html5(四)----使用canvas画一个时钟
- 延时动画方法
- 程序的内存布局
- mathtype批量修改公式的字体大小
- Aspose.words编程指南之DocumentBuilder二
- API Hook完全手册
- Android系统启动流程
- android 之popwindow 小结
- Unity 2D游戏开发教程之游戏精灵的开火状态
- mapreduce的二次排序 SecondarySort
- 简单拓扑发现实现过程及其物联网应用设想
- Json 转 指定 C#对象,给c#对象赋值
- fackbook的Fresco (FaceBook推出的Android图片加载库-Fresco)