setSubmitName
设置表格的 SubmitName。
SubmitName 用来标记当前 Table 对象在控件保存时需要被提交到 SaveDataPage 服务器页面。
只有当您需要提交当前 Table 中的数据时,才需要定义 SubmitName。 如果您定义了SubmitName,当保存文档时,此 SubmitName 将被作为 com.zhuozhengsoft.pageoffice.excel.SheetReader.openTable(string) 方法的参数来获取指定的 Table 对象。 如果您使用的文档打开模式是OpenModeType.xlsSubmitForm,并且当前表格对象定义了SubmitName,那么此表格会自动处于可编辑状态。如果此时您需要将表格设为只读,只要给当前表格的 ReadOnly 属性赋值true就可以了。
语法:
public void setSubmitName(java.lang.String value)
throws java.lang.Exception,
java.io.IOException
参数:
value
- 由开发者自由定义,一般命名为数据库里数据表的名字,代码易于理解。这里定义的SubmitName在文档保存时将被用作 com.zhuozhengsoft.pageoffice.excel.SheetReader.openTable(string) 方法的参数。
SubmitName 在同一个Sheet里应该保持唯一。SubmitName 对大小写敏感。
抛出:
java.lang.Exception
java.io.IOException
示例:
下面的示例展示了如何定义需要提交的Cell和Table。
WorkbookWriter wbWriter = new WorkbookWriter();
SheetWriter sheetWriter1 = wbWriter.openSheet("sheet1");
sheetWriter1.openCell("C2").setSubmitName("CompanyName"); // 此单元格需要提交
sheetWriter1.openTable("B6:F10").setSubmitName("SalesInfo");// 此表格需要提交
poCtrl1.setSaveDataPage("savedata.jsp");
poCtrl1.setWriter(wbWriter);
poCtrl1.webOpen("doc/test.xls", OpenModeType.xlsSubmitForm, "张三");