历史版本3 :填报预览专有 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

getWidgetByName编辑

方法getWidgetByName(name)通过控件名称获取填报单元格中的控件
     参数name: string

控件名称,字符串

注:填报控件控件名称默认无,可以自行添加

   返回值object 

控件对象,需要结合控件的属性/方法使用;当单元格扩展时,返回的是控件对象数组

     示例

将获取到的报表对象定义为 report,获取单元格中的下拉框控件 comboBox0:

report.getWidgetByName("comboBox0");

普通报表中,获取单元格中的下拉框控件 comboBox0 

_g().getWidgetByName("comboBox0");
  应用示例

填报时,成绩只允许输入一次,控件输入值后设置为不可用:

2021-09-07_10-46-26.gif

    移动端支持移动端

getWidgetByCell编辑

方法getWidgetByCell(cell)通过单元格地址获取填报单元格中的控件
     参数cell:string单元格地址、字符串
   返回值object 控件对象,需要结合控件的属性/方法使用
     示例

将获取到的报表对象定义为 report ,获取报表 A1 单元格中的下拉框控件:

report.getWidgetByCell("A1");

填报报表中,获取 A1 单元格中的下拉框控件:

_g().getWidgetByCell("A1");
  应用示例

填报时,成绩只允许输入一次,获取单元格中的控件输入值后将其设置为不可用:

2021-09-07_10-46-26.gif

   移动端支持移动端

appendReportRC编辑

方法appendReportRC(num,cell)在特定的位置插入行
     参数

num:number

cell:string

num:插入的行数,数字

cell:插入位置的单元格编号,如果无此参数,则插入位置为鼠标焦点所在行

   返回值void
     示例

将获取到的报表对象定义为 report ,在报表 A1 单元格行后插入 3 行:

report.appendReportRC(3,"A1");

填报报表中,在报表 A1 单元格行后插入 3 行:

_g().appendReportRC(3,"A1");
  应用示例

填报时,点击按钮,插入自定义行数:

2021-09-09_11-40-46.gif


   移动端不支持移动端

appendReportRow编辑

方法_g().appendReportRow(this.options.location, this.options.reportIndex,num)插入行(默认在当前行插入)
     参数

num:number

num:插入的行数,数字

   返回值void
     示例

将获取到的报表对象定义为 report ,在报表当前行插入 3 行:

report.appendReportRow(this.options.location, this.options.reportIndex,3);

填报报表中,在报表最后一行后插入 3 行:

_g().appendReportRow(this.options.location, this.options.reportIndex,3);
  应用示例

填报时,点击按钮,插入自定义行数:

2021-09-09_11-40-46.gif


   移动端支持移动端

deleteReportRC编辑

方法deleteReportRC(cell)删除行
     参数

cell:string

cell:删除位置的单元格编号。如果无此参数,则删除位置为鼠标焦点所在行

   返回值void
     示例

将获取到的报表对象定义为 report ,删除 A1 单元格所在的行:

report.deleteReportRC("A1");

填报报表中,删除 A1 单元格所在的行:

_g().deleteReportRC("A1");
  应用示例

填报时,点击按钮,删除鼠标所在的单元格行:

2021-09-09_14-48-59.gif

   移动端不支持移动端

deleteRows编辑

方法deleteRows([cell])删除行
     参数

cell:string

cell:删除位置的单元格编号数组

   返回值void
     示例

将获取到的报表对象定义为 report ,删除 A1、A2 单元格所在的行:

report.deleteRows(['A1','A2']);

填报报表中,删除 A1 、A2 单元格所在的行:

_g().deleteRows(['A1','A2']);
  应用示例

填报时,点击按钮,删除 A1、A2 单元格所在的行:

   移动端不支持移动端

refreshAllSheets编辑

方法refreshAllSheets()重新查询,刷新所有 sheet,刷新后会停留在上次查看的 sheet
     参数

-

-

   返回值void
     示例

将获取到的报表对象定义为 report ,刷新所有的 sheet:

report.refreshAllSheets();

填报报表中,刷新所有的 sheet:

_g().refreshAllSheets();
  应用示例

点击按钮刷新所有 sheet ,刷新后依旧停留在当前所在的 sheet3:

2021-09-09_16-53-00.gif

   移动端支持移动端

loadSheetByIndex编辑

方法loadSheetByIndex(index)切换到指定 sheet,参数为 sheet 序号
     参数

index:number

index:sheet 序号( 从 0 开始 )

   返回值void
     示例

将获取到的报表对象定义为 report ,切换到第 2 个 sheet:

report.loadSheetByIndex(1);

填报报表中,切换到第 2 个 sheet:

_g().loadSheetByIndex(1);
  应用示例

如果报表中有多个 sheet 页,预览时,默认展示第 2 个 sheet 页:

2021-09-09_19-13-55.gif

   移动端不支持移动端

loadSheetByName编辑

方法loadSheetByName(name)切换到指定 sheet,参数为 sheet 名称
     参数

name:string

name:sheet 名称

   返回值void
     示例

将获取到的报表对象定义为 report ,切换到名称为“商品”的 sheet:

report.loadSheetByName("商品");

填报报表中,切换到名称为“商品”的 sheet:

_g().loadSheetByName("商品");
  应用示例

如果报表中有多个 sheet 页,预览时,默认展示名称为“sheet2”的 sheet 页:

2021-09-09_19-13-55.gif

   移动端不支持移动端

isDirtyPage编辑

方法isDirtyPage()判断页面是否被编辑过
     参数

-

-

   返回值boolean

页面是否被编辑过,布尔型

  • true:编辑过

  • false:未编辑过

     示例

将获取到的报表对象定义为 report ,判断页面是否被编辑过:

report.isDirtyPage();

填报报表中,判断页面是否被编辑过:

_g().isDirtyPage();
  应用示例

点击按钮,判断页面是否被编辑过:

2021-09-14_17-55-45.gif

   移动端不支持移动端

isAutoStash编辑

方法isAutoStash()判断是否开启自动暂存,自动暂存可参考:填报暂存
     参数

-

-

   返回值boolean

是否开启自动暂存,布尔型

  • true:开启

  • false:未开启

     示例

将获取到的报表对象定义为 report ,判断是否开启自动暂存:

report.isAutoStash();

填报报表中,判断是否开启自动暂存:

_g().isAutoStash();
  应用示例

-

   移动端不支持移动端

writeReport编辑

方法writeReport(sheetindex)强制提交,不校验
     参数

sheetindex:number

提交第几个 sheet,数字,从 0 开始,参数为空代表提交所有 sheet

   返回值void
     示例

将获取到的报表对象定义为 report ,提交第 2 个 sheet:

report.writeReport(1);

填报报表中,提交第 2 个 sheet:

_g().writeReport(1);
  应用示例

自定义一个「提交」按钮,实现点击按钮时提交填报内容:

2021-09-09_19-57-04.gif

   移动端支持移动端

verifyAndWriteReport编辑

方法verifyAndWriteReport(isallsheet)校验并提交报表
     参数

isallsheet:boolean

isallsheet:是否提交所有的 sheet

  • true:提交所有

  • false:提交当前 sheet

   返回值void
     示例

将获取到的报表对象定义为 report ,提交所有 sheet:

report.verifyAndWriteReport(true);

填报报表中,判断是否开启自动暂存:

_g().verifyAndWriteReport(true);
  应用示例

自定义一个「提交」按钮,实现点击按钮时校验提交填报内容

2021-09-09_19-57-04.gif

   移动端支持移动端

verifyReport编辑

方法verifyReport()数据校验
     参数-

-

   返回值void
     示例

将获取到的报表对象定义为 report ,提交校验:

report.verifyReport();

填报报表中,提交校验:

_g().verifyReport()
  应用示例

自定义一个「校验」按钮,实现点击按钮时提交校验:

2021-09-09_20-18-53.gif

   移动端支持移动端

importExcel编辑

方法importExcel(importStyle)导入 Excel
     参数

importStyle:

导入方式,字符串,

  • 不写时为普通导入

  • "customize":自定义导入

   返回值void
     示例

将获取到的报表对象定义为 report ,调出导入 Excel 的功能弹窗,以普通导入的方式导入 Excel:

report.verifyReport();

填报报表中,调出导入 Excel 功能弹窗,以普通导入的方式导入 Excel:

_g().verifyReport();

填报报表中,调出导入 Excel 功能弹窗,以自定义导入的方式导入 Excel:

_g().importExcel("customize");
  应用示例

自定义一个 「导入Excel」按钮,点击实现导入 Excel:

2021-09-09_20-36-00.gif

   移动端不支持移动端

importExcel_Clean编辑

方法importExcel_Clean()「清空导入」的方式导入 Excel
     参数-

-

   返回值void
     示例

将获取到的报表对象定义为 report ,调出导入 Excel 功能弹窗,以「清空导入」的方式导入 Excel :

report.importExcel_Clean();

填报报表中,调出导入 Excel 功能弹窗,以「清空导入」的方式导入 Excel :

_g().importExcel_Clean();
  应用示例

自定义一个 「导入Excel」 按钮,点击以「清空导入」的方式导入 Excel :

2021-09-09_20-36-00.gif

   移动端不支持移动端

importExcel_Append编辑

方法importExcel_Append()增量导入」的方式导入 Excel
     参数-

-

   返回值void
     示例

将获取到的报表对象定义为 report ,调出导入 Excel 功能弹窗,以增量导入的方式导入 Excel:

report.importExcel_Append();

填报报表中,调出导入 Excel 功能弹窗,以增量导入的方式导入 Excel :

_g().importExcel_Append();
  应用示例

自定义一个「导入Excel」按钮,点击以增量导入的方式导入 Excel:

2021-09-09_20-36-00.gif

   移动端不支持移动端

importExcel_Cover编辑

方法importExcel_Cover()覆盖导入的方式导入 Excel:
     参数-

-

   返回值void
     示例

将获取到的报表对象定义为 report ,调出导入 Excel: 功能弹窗,以覆盖导入的方式导入 Excel:

report.importExcel_Cover();

填报报表中,调出导入 Excel:功能弹窗,以覆盖导入的方式导入 Excel:

_g().importExcel_Cover();
  应用示例

自定义一个「导入Excel」按钮,点击以覆盖导入的方式导入 Excel:

2021-09-09_20-36-00.gif

   移动端不支持移动端

stash编辑

方法stash(undefined,true)暂存
     参数undefined,true

固定格式,作用为弹出暂存成功的提示,如果不需要提示,直接不写即可

   返回值void
     示例

将获取到的报表对象定义为 report ,暂存并弹出暂存成功的提示:

report.stash(undefined,true);

填报报表中,暂存并弹出暂存成功的提示:

_g().stash(undefined,true);
填报报表中,暂存但不弹出暂存成功的提示:
_g().stash();
  应用示例

-

   移动端不支持移动端

clear编辑

方法clear()清空暂存
     参数-

无,如果不需要清空确认提醒以及清空成功的提示,则可以写 undefined,false

   返回值void
     示例

将获取到的报表对象定义为 report ,清空暂存并弹出清空暂存成功的提示:

report.clear();

填报报表中,清空暂存并弹出清空暂存成功的提示:

_g().clear();

填报报表中,清空暂存但不弹出清空确认提醒以及清空成功的提示:

_g().clear(undefined,false);
  应用示例-
   移动端不支持移动端