填報預覽專有

和 10.0 差別：

無變動，10.0 也支援

元件名稱，字串

注：儲存格中元件，預設無名稱，可以在「元件名稱」處為其新增。

元件物件，需要結合元件的屬性/方法使用，當儲存格擴展時，傳回找到的元件陣列中的第一個元件

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

_g().getWidgetByName("comboBox0");

填報時，成績只允許輸入一次，成績元件輸入值後將其設定為不可用：

點選可下載範本：元件輸入值後設定為不可用.cpt

範例1：填報報表中，獲取 A1 儲存格中的元件

_g().getWidgetByCell("A1");

範例2：填報報表中，透過行列來獲取儲存格中的元件，如下獲取第 1 行第 1 列即 A1 儲存格中的元件。columnRow2CellStr API是將行列索引轉成儲存格地址，相關介紹可查看對應文檔。

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

填報時，成績只允許輸入一次，獲取 B4 儲存格中的元件輸入值後將其設定為不可用：

點選可下載範本：元件輸入值後設定為不可用(單元格地址方式獲取）.cpt

元件名稱，字串

注：儲存格中元件，預設無名稱，可以在「元件名稱」處為其新增。

元件物件陣列，需要結合元件的屬性/方法使用；當儲存格擴展時，傳回的是元件物件陣列

範例：普通報表中，獲取儲存格中名稱為 comboBox0 的所有下拉框元件

_g().getWidgetsByName("comboBox0");

填報時，點選按鈕，獲取無線電鈕組元件擴展的所有值：

詳細實現方法可參考：JS獲取擴展元件的所有值

num：number

cell：string

cell：插入位置的儲存格編號，如果無此參數，則插入位置為滑鼠焦點所在行

範例：填報報表中，在報表 A1 儲存格行後插入 3 行

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

填報時，點選按鈕，插入自訂行數：

點選可下載範本：在特定的位置插入列.cpt

cell：string

sheetindex：number

num：number

cell：「插入行按鈕」所在儲存格的編號，字串

sheetindex：sheet 編號，數字，從 0 開始

num：插入的行數，數字

示例1：

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

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

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

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

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

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

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

填報時，點選按鈕，插入自訂行數：

詳細實現方法可參考：JS實現插入自訂行數

cell：string

cell：刪除位置的儲存格編號。如果無此參數，則刪除位置為滑鼠焦點所在行

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

_g().deleteReportRC("A1");

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

_g().deleteReportRC();

填報時，點選按鈕，刪除滑鼠所在的儲存格行：

詳細實現方法可參考：JS自訂插入和刪除行按鈕

cell：string

cell：刪除位置的儲存格編號陣列

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

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

填報報表中，實現根據選項選批量刪除：

詳細實現方法可參考：JS實現複選按鈕元件全選和批量操作

-

-

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

_g().refreshAllSheets();

點選按鈕重新整理所有 sheet ，重新整理後依舊停留在當前所在的 sheet3：

點選可下載範本：重新整理後停留在當前的sheet .cpt

index：number

index：sheet 序號( 從 0 開始 )

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

_g().loadSheetByIndex(1);

如果報表中有多個 sheet 頁，預覽時，預設展示第 2 個 sheet 頁:

點選可下載範本：重新整理後停留在當前的sheet.cpt

name：string

name：sheet 名稱

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

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

如果報表中有多個 sheet 頁，預覽時，預設展示名稱為“sheet2”的 sheet 頁：

點選可下載範本：預設展示特定sheet.cpt

sheetindex：number

提交第幾個 sheet，數字，從 0 開始，參數為空代表提交所有 sheet

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

_g().writeReport(1);

自訂一個「提交」按鈕，實現點選按鈕時提交填報內容：

點選可下載範本：強制提交不校驗.cpt

isallsheet：boolean

isallsheet：是否提交所有的 sheet

• true：提交所有

• false：提交當前 sheet

示例：填报报表中，提交所有 sheet

_g().verifyAndWriteReport(true);

自訂一個「提交」按鈕，實現點選按鈕時校驗提交填報內容：

點選可下載範本：校驗提交.cpt

-

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

_g().verifyReport();

自訂一個「校驗」按鈕，實現點選按鈕時提交校驗：

點選可下載範本：自訂校驗按鈕.cpt

importStyle：

匯入方式，字串，

• 不寫時為普通匯入

• "customize"：自訂匯入

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

_g().importExcel();

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

_g().importExcel("customize");

自訂一個 「匯入Excel」按鈕，點選實現匯入 Excel：

點選可下載範本：自訂匯入的方式匯入Excel.cpt

-

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

_g().importExcel_Clean();

自訂一個 「匯入Excel」 按鈕，點選以「清空匯入」的方式匯入 Excel ：

點選可下載範本：多次匯入.cpt

-

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

_g().importExcel_Append();

自訂一個「匯入Excel」按鈕，點選以增量匯入的方式匯入 Excel：

點選可下載範本：多次匯入.cpt

-

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

_g().importExcel_Cover();

自訂一個「匯入Excel」按鈕，點選以改寫匯入的方式匯入 Excel：

點選可下載範本：多次匯入.cpt

-

-

頁面是否被編輯過，布林型

• true：編輯過

• false：未編輯過

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

_g().isDirtyPage();

點選按鈕，判斷頁面是否被編輯過:

點選可下載範本：查看頁面編輯狀態.cpt

-

-

是否開啟自動暫存，布林型

• true：開啟

• false：未開啟

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

_g().isAutoStash();

-

固定格式，作用為彈出暫存成功的提示，如果不需要提示，直接不寫即可

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

_g().stash(undefined,true);

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

_g().stash();

-

無，如果不需要清空確認提醒以及清空成功的提示，則可以寫 undefined,false

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

_g().clear();

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

_g().clear(undefined,false);