使用过PageOffice动态生成word文档的人都知道,PageOffice可以给word文档的指定位置进行填充,这里我们所说的指定位置在PageOffice的专业术语里面有两个概念,一个叫做数据区域(DataRegion),另一个叫做数据标签(DataTag)。
一、 概念
数据区域:是Word文档中具有 "PO_" 前缀命名的书签所定位的文档区域。简单来说,数据区域就是一种特殊的Word书签对象,便于定位Word文档中的内容。
数据标签:是任意的有效字符组成的特殊样式的字符串(如“【时间】”、“{姓名}”、“${name}”等等)作为标记,理论上这样的字符串(比如:“性别”、“地址”、“aa”、“bbcc”)也可以当做数据标签,但是不推荐使用,因为这样的标签不能从视觉上直观的看出word文档中包含了哪些数据标签。
二、使用
数据区域里面可以填充些的内容:文本、图片、Word文件、Excel文件。
复制代码
WordDocument doc = new WordDocument();
//填充文本
DataRegion dataRegion1 = doc.openDataRegion("PO_userName");
dataRegion1.setValue("张三");
//还可以给填充的文本设置字体,颜色,粗体等样式
dataRegion1.getFont().setColor(Color.blue);
dataRegion1.getFont().setSize(24);
dataRegion1.getFont().setName("隶书");
dataRegion1.getFont().setBold(true);
//填充图片
doc.openDataRegion("PO_deptName").setValue("[image]img/123.jpg[/image]");
//填充word文件
doc.openDataRegion("PO_deptName").setValue("[word]doc/aabb.doc[/word]");
//填充excel文件
doc.openDataRegion("PO_deptName").setValue("[excel]doc/bbcc.xls[/excel]");
复制代码
数据标签中可以填充的内容:文本。
复制代码
WordDocument doc = new WordDocument();
//填充文本,还可以设置字体、颜色等样式
DataTag deptTag = doc.openDataTag("{部门名}");
deptTag.setValue("市场部");
deptTag.getFont().setColor(Color.GREEN);
deptTag.getFont().setName("宋体");
deptTag.getFont().setSize(28);
复制代码
三、区别
DataRegion类是要与书签结合使用的,既可以先在Word文档中插入以“PO_”开头的书签定义数据区域,再在程序中通过WordDocument类对象的OpenDataRegion(String DataRegionName)方法获取DataRegion对象;又可以通过WordDocument类对象的CreateDataRegion(String NewDataRegionName, DataRegionInsertType insertType, String RelativeDataRegionName)方法直接创建数据区域从而获取DataRegion类对象。而DataTag类是与Word文档中用户插入的自定义特征文本结合使用的。在程序中DataTag类对象只能通过OpenDataTag(String DataTagName)方法获取。
另外,数据区域的名称(即书签名称)必须以“PO_”开头,两个书签之间要有最少一个的有效字符,不能重复,数据区域的名称和Word文档中的位置是一一对应的。而数据标签的名称就是具有一定特征的Word字符串文本,便于定位Word文档中的内容,可以重复,数据标签的名称和Word文档中的位置是一对多的关系。也就是说,同一个Name的DataRegion只能表示Word文档中唯一一个位置,而在Word文档中相同的特征字符串可以在多处出现。
所以DataRegion的优点是:DataRegion既可以填充文档内容,还可以创建文档内容、提交用户在DataRegion里输入的内容、获取用户提交的DataRegion里的内容,而DataTag只能用于填充文档内容。DataRegion的缺点是:DataRegion无法简单重复,必须要设置不同的书签,而DataTag可以在文档中多处生成需要重复的内容。
而应该用DataTag还是用DataRegion,则应该视具体的需求而定。当用户要提交Word中某部分数据或者想要获取Word中提交的某部分数据时则必须要用DataRegion;当用户不需提交数据或者获取数据,并且填充的数据无重复项时,则两者均可;当用户不需提交数据或者获取数据,且填充的数据有多个重复项时,虽然两者均可,但是为了编程简便、代码高效,建议使用DataTag。