填报预览专有

和 10.0 区别：

无变动，10.0 也支持

控件名称，字符串

注：单元格中控件，默认无名称，可以在「控件名称」处为其添加。

控件对象，需要结合控件的属性/方法使用，当单元格扩展时，返回找到的控件数组中的第一个控件

示例1：若获取到的报表对象定义为 report，获取单元格中的下拉框控件 comboBox0

report.getWidgetByName("comboBox0");

示例2：普通报表中，获取单元格中的下拉框控件 comboBox0 

_g().getWidgetByName("comboBox0");

填报时，成绩只允许输入一次，成绩控件输入值后将其设置为不可用：

点击可下载模板：控件输入值后设置为不可用.cpt

示例1：若获取到的报表对象定义为 report ,获取报表 A1 单元格中的控件

report.getWidgetByCell("A1");

示例2：填报报表中，获取 A1 单元格中的控件

_g().getWidgetByCell("A1");

示例3：填报报表中，通过行列来获取单元格中的控件，如下获取第 1 行第 1 列即 A1 单元格中的控件。columnRow2CellStr 接口是将行列索引转成单元格地址，相关介绍可查看对应文档。

_g().getWidgetByCell(FR.columnRow2CellStr({col:0, row:0}))

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

点击可下载模板：控件输入值后设置为不可用(单元格地址方式获取）.cpt

控件名称，字符串

注：单元格中控件，默认无名称，可以在「控件名称」处为其添加。

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

示例1：若获取到的报表定义为 report，获取单元格中名称为 comboBox0 的所有下拉框控件

report.getWidgetsByName("comboBox0");

示例2：普通报表中，获取单元格中名称为 comboBox0 的所有下拉框控件

_g().getWidgetsByName("comboBox0");

填报时，点击按钮，获取单选按钮组控件扩展的所有值：

详细实现方法可参考：JS获取扩展控件的所有值

num：number

cell：string

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

示例1：若获取到的报表对象定义为 report ,在报表 A1 单元格行后插入 3 行

report.appendReportRC(3,"A1");

示例2：填报报表中，在报表 A1 单元格行后插入 3 行

_g().appendReportRC(3,"A1");

填报时，点击按钮，插入自定义行数：

点击可下载模板：在特定的位置插入行.cpt

cell：string

sheetindex：number

num：number

cell：「插入行按钮」所在单元格的编号，字符串

sheetindex：sheet 编号，数字，从 0 开始

num：插入的行数，数字

示例1：若获取到的报表对象定义为 report，插入行按钮在“sheet1”的“F1”单元格

使用该 JS 可调用对象为 report 的 F1 单元格的插入行按钮插入 3 行

report.appendReportRow("F1", 0,3);

示例2：

填报报表中，插入行按钮在“sheet1”的“F1”单元格。

使用该 JS 可调用 F1 单元格的插入行按钮插入 3 行

_g().appendReportRow("F1", 0,3);

示例3：通过 this.options.location, this.options.reportIndex 获取插入行按钮、sheet 编号后，插入 3 行

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

示例4：填报报表中，通过 this.options.location, this.options.reportIndex 获取插入行按钮、sheet 编号后，插入 3 行

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

填报时，点击按钮，插入自定义行数：

详细实现方法可参考：JS实现插入自定义行数

cell：string

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

示例1：若获取到的报表对象定义为 report ,删除 A1 单元格所在的行

report.deleteReportRC("A1");

示例2：填报报表中，删除 A1 单元格所在的行

_g().deleteReportRC("A1");

示例3：填报报表中，删除鼠标所在单元格位置的行

_g().deleteReportRC();

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

详细实现方法可参考：JS自定义插入和删除行按钮

cell：string

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

示例1：若获取到的报表对象定义为 report ,删除 A1、A2 单元格所在的行

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

示例2：填报报表中，删除 A1 、A2 单元格所在的行

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

填报报表中，实现根据选项选批量删除：

详细实现方法可参考：JS实现复选按钮控件全选和批量操作

-

-

示例1：若获取到的报表对象定义为 report ,刷新所有的 sheet

report.refreshAllSheets();

示例2：填报报表中，刷新所有的 sheet

_g().refreshAllSheets();

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

点击可下载模板：刷新后停留在当前的sheet.cpt

index：number

index：sheet 序号( 从 0 开始 )

示例1：若获取到的报表对象定义为 report ,切换到第 2 个 sheet

report.loadSheetByIndex(1);

示例2：填报报表中，切换到第 2 个 sheet

_g().loadSheetByIndex(1);

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

点击可下载模板：默认展示特定sheet.cpt

name：string

name：sheet 名称

示例1：若获取到的报表对象定义为 report ,切换到名称为“商品”的 sheet

report.loadSheetByName("商品");

示例2：填报报表中，切换到名称为“商品”的 sheet

_g().loadSheetByName("商品");

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

点击可下载模板：默认展示特定sheet.cpt

sheetindex：number

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

示例1：若获取到的报表对象定义为 report ，提交第 2 个 sheet

report.writeReport(1);

示例2：填报报表中，提交第 2 个 sheet

_g().writeReport(1);

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

点击可下载模板：强制提交不校验.cpt

isallsheet：boolean

isallsheet：是否提交所有的 sheet

• true：提交所有

• false：提交当前 sheet

示例1：若获取到的报表对象定义为 report ,提交所有 sheet

report.verifyAndWriteReport(true);

示例2：填报报表中，判断是否开启自动暂存

_g().verifyAndWriteReport(true);

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

点击可下载模板：校验提交.cpt

-

示例1：若获取到的报表对象定义为 report ，提交校验

report.verifyReport();

示例2：填报报表中，提交校验

_g().verifyReport();

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

点击可下载模板：自定义校验按钮.cpt

importStyle：

导入方式，字符串，

• 不写时为普通导入

• "customize"：自定义导入

示例1：若获取到的报表对象定义为 report ，调出导入 Excel 的功能弹窗，以普通导入的方式导入 Excel

report.importExcel();

示例2：填报报表中，调出导入 Excel 功能弹窗，以普通导入的方式导入 Excel

_g().importExcel();

示例3：填报报表中，调出导入 Excel 功能弹窗，以自定义导入的方式导入 Excel

_g().importExcel("customize");

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

点击可下载模板：自定义导入的方式导入 Excel.cpt

-

示例1：若获取到的报表对象定义为 report ,调出导入 Excel 功能弹窗，以「清空导入」的方式导入 Excel

report.importExcel_Clean();

示例2：填报报表中，调出导入 Excel 功能弹窗，以「清空导入」的方式导入 Excel 

_g().importExcel_Clean();

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

点击可下载模板：多次导入Excel.cpt

-

示例1：若获取到的报表对象定义为 report ,调出导入 Excel 功能弹窗，以增量导入的方式导入 Excel

report.importExcel_Append();

示例2：填报报表中，调出导入 Excel 功能弹窗，以增量导入的方式导入 Excel 

_g().importExcel_Append();

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

点击可下载模板：多次导入Excel.cpt

-

示例1：若获取到的报表对象定义为 report ,调出导入 Excel： 功能弹窗，以覆盖导入的方式导入 Excel

report.importExcel_Cover();

示例2：填报报表中，调出导入 Excel：功能弹窗，以覆盖导入的方式导入 Excel

_g().importExcel_Cover();

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

点击可下载模板：多次导入Excel.cpt

-

-

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

• true：编辑过

• false：未编辑过

示例1：若获取到的报表对象定义为 report ,判断页面是否被编辑过

report.isDirtyPage();

示例2：填报报表中，判断页面是否被编辑过

_g().isDirtyPage();

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

点击可下载模板：查看页面编辑状态.cpt

-

-

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

• true：开启

• false：未开启

示例1：若获取到的报表对象定义为 report ，判断是否开启自动暂存

report.isAutoStash();

示例2：填报报表中，判断是否开启自动暂存

_g().isAutoStash();

-

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

示例1：若获取到的报表对象定义为 report ,暂存并弹出暂存成功的提示

report.stash(undefined,true);

示例2：填报报表中，暂存并弹出暂存成功的提示

_g().stash(undefined,true);

_g().stash();

-

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

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

report.clear();

示例2：填报报表中，清空暂存并弹出清空暂存成功的提示

_g().clear();

示例3：填报报表中，清空暂存但不弹出清空确认提醒以及清空成功的提示

_g().clear(undefined,false);