openDataRegion
打开指定的数据区域,并返回 DataRegionWriter 对象。
语法:
public DataRegionWriter openDataRegion(java.lang.String dataRegionName)
throws java.lang.Exception,
java.io.IOException
参数:
dataRegionName
- DataRegion 的名称。
返回:
返回 DataRegionWriter 对象。
抛出:
java.lang.Exception
java.io.IOException
示例:
示例代码 1:展示如何调用 OpenDataRegion 方法打开数据区域,并且填充数据到Word文档指定位置处。
在运行本代码前,请手动打开test.doc文档,在相应的位置处插入书签"PO_CompanyName" 和 "PO_ProductName"。
WordDocumentWriter doc = new WordDocumentWriter();
doc.openDataRegion("CompanyName").setValue("卓正软件");
doc.openDataRegion("ProductName").setValue("PageOffice");
PageOfficeCtrl poCtrl1 = new PageOfficeCtrl(request);
poCtrl1.setWriter(doc);
poCtrl1.webOpen("doc/test.doc", OpenModeType.docReadOnly, "张三");
示例代码 2:展示如何将Word文档设置为Form表单输入视图,如何设置可编辑数据区域。此例中,只有CompanyName和ProductName位置处的内容是可编辑的,文档其他部分都是只读的。
如果需要约束用户输入规范的值,可以定义数据区域单击事件执行的js函数OnWordDataRegionClick,用户点击该数据区域时可弹出选择框选取用户需要的值。
在运行本代码前,请手动打开test.doc文档,在相应的位置处插入书签"PO_CompanyName" 和 "PO_ProductName"。
PageOfficeCtrl poCtrl1 = new PageOfficeCtrl(request);
WordDocumentWriter doc = new WordDocumentWriter();
DataRegionWriter dataRegion = doc.openDataRegion("CompanyName");
dataRegion.setValue("卓正软件");// 数据区域可以赋初值
dataRegion.setEditing(true);// 用户可输入
doc.openDataRegion("ProductName").setEditing(true);// 用户可输入
poCtrl1.setWriter(doc);
poCtrl1.setSaveDataPage("savedata.jsp");
poCtrl1.webOpen("doc/test.doc", OpenModeType.docSubmitForm, "张三");
function OnWordDataRegionClick(Name, Value, Left, Bottom) {
if (Name == "PO_CompanyName") {
pageofficectrl.ShowHtmlModalDialog("HTMLPage.htm", Value, "left=" + Left + "px;top=" + Bottom + "px;width=400px;height=300px;");
}
}
另请参见:
WordDocumentReader.openDataRegion()方法中的示例代码,学习如何编写savedata.jsp获取文档保存时提交的用户输入内容。