填報預覽專有

和 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 API是將行列索引轉成儲存格地址，相關介紹可查看對應文檔。

_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 ：

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

-

範例1：若獲取到的報表物件定義為 report ,調出匯入 Excel 功能彈窗，以增量匯入的方式匯入 Excel

report.importExcel_Append();

範例2：填報報表中，調出匯入 Excel 功能彈窗，以增量匯入的方式匯入 Excel 

_g().importExcel_Append();

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

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

-

範例1：若獲取到的報表物件定義為 report ,調出匯入 Excel： 功能彈窗，以改寫匯入的方式匯入 Excel

report.importExcel_Cover();

範例2：填報報表中，調出匯入 Excel：功能彈窗，以改寫匯入的方式匯入 Excel

_g().importExcel_Cover();

自訂一個「匯入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);