com.zhuozhengsoft.pageoffice.wordwriter
类 DataTag

java.lang.Object
  com.zhuozhengsoft.pageoffice.wordwriter.DataTag

public class DataTag
extends java.lang.Object

DataTag 类，代表一个数据标签对象。

数据标签对象，代表Word文档中具有此特征字符串的所有文本区域。您只能通过调用 WordDocument.openDataTag 方法获得 DataTag 对象。

什么是数据标签？数据标签是Word文档中用户插入的自定义特征文本。简单来说，数据标签就是具有一定特征的Word字符串文本，便于定位Word文档中的内容。

这里举个简单的例子说明什么是数据标签：假设开发者需要在待打开的Word文档指定位置处显示产品名称，就可以先手动打开此Word文档，在指定位置处插入文本"{ProductName}"，保存文档。这样数据标签"{ProductName}"就定义好了。 编写代码 doc.openDataTag("{ProductName}").setValue("PageOffice"); 即可在此数据标签处生成想要的内容。

DataTag 和 DataRegion 的区别：DataRegion 的 Name 和Word文档中的位置是一一对应的；而 DataTag 的 Name 和Word文档中的位置是一对多的关系。也就是说，在Word文档中相同的特征字符串可以在多处出现， 而同一个Name的DataRegion只能表示Word文档中唯一一个位置。

所以DataTag的缺点是：DataTag只能用于填充文档内容，而DataRegion既可以填充文档内容，还可以创建文档内容、提交用户在DataRegion里输入的内容。 DataTag的优点是：DataTag可以在文档中多处生成需要重复的内容，而DataRegion无法简单重复，必须要设置不同的书签。应该用DataTag还是用DataRegion，视具体需求定。

版本：

2.0

作者：

北京卓正志远软件有限公司

方法摘要

Font	getFont() 获取字体对象。
java.lang.String	getName() 获取 DataTag 的名称。
ParagraphFormat	getParagraphFormat() 获取段落格式对象。
Shading	getShading() 获取Shading对象。
void	setValue(java.lang.String value) 设置 DataTag 的值。

从类 java.lang.Object 继承的方法

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细信息

getName

public java.lang.String getName()
                         throws java.io.IOException

获取 DataTag 的名称。

抛出：

java.io.IOException

setValue

public void setValue(java.lang.String value)
              throws java.lang.Exception,
                     java.io.IOException

设置 DataTag 的值。

抛出：

java.lang.Exception

java.io.IOException

另请参见：

WordDocument.openDataTag()方法中的示例代码，学习如何设置数据标签的值。

getFont

public Font getFont()

获取字体对象。

返回：

Word中定义的字体对象。

getParagraphFormat

public ParagraphFormat getParagraphFormat()

获取段落格式对象。

返回：

Word中定义的段落格式对象。

getShading

public Shading getShading()

获取Shading对象。

返回：

Word中定义的Shading对象。