版本
報表伺服器版本 | 行動端版本 | 功能變動 |
---|---|---|
11.0 | - | 和 10.0 差別: 10.0 無此類API |
11.0.7 | - | 決策報表新增 setHeight、getHeight、getCell、setWidth、getWidth、getCell、getIndex、setStyle、showToolTip API。 |
11.0.7 | - | 安裝了「FineVis資料視覺化」插件 V1.8.0 及之後版本,FVS 視覺化看板支援 setHeight、getHeight、getCell、setWidth、getWidth、getIndex、setStyle、showToolTip API。 |
11.0.10 | 11.0.70 | 普通報表支援setHeight、getHeight、getCell、setWidth、getWidth、getCell、getIndex、setStyle、showToolTip API。 |
11.0.14 | - | 決策報表支援getWidth |
在使用API前,請務必先仔細閱讀 JS API 相容說明,API預設支援普通報表和決策報表(新版)。
setHeight
方法 | setHeight(height) | 設定儲存格行高,需要先透過 getRow(index) 方法獲取到儲存格行。 |
---|---|---|
參數 | height: number | height: 行高 |
回傳值 | void | |
範例 | 範例1:若獲取到的表格行物件定義為 row ,將該行行高設定為 25
範例2:決策報表中將 report0 報表塊第 3 行的行高設定為 25
範例3:普通報表中將第3行的行高設定為 25
範例4:將 FVS 視覺化看板中的「表格1」組件第 1 行的行高設定為 40:
範例5:決策報表將 report0 報表塊第 1 行的行高設定為 45 _g().getWidgetByName('report0').getRow(1).setHeight(45); | |
應用範例 | 點選按鈕,將第 1 行的行高設定為 45: 點選下載範本:点击修改单元格行高.frm FVS 視覺化看板:点击修改单元格行高.fvs 注:該API不支援凍結列的情況 | |
行動端 | 不支援行動端 |
getHeight
方法 | getHeight() | 獲取儲存格行高,需要先透過 getRow(index) 方法獲取到儲存格行。 |
---|---|---|
參數 | - | - |
回傳值 | number | 行高,數字 |
範例 | 範例1:若獲取到的表格行物件定義為 row ,獲取該行的行高
範例2:獲取決策報表中將 report0 報表塊第 3 行的行高
範例3:獲取普通報表中第 3 行的行高:
範例4:獲取 FVS 視覺化看板中的「表格1」組件第 3 行的行高
範例5:獲取決策報表 report0 報表塊第 1 行的行高後彈窗顯示
| |
應用範例 | 點選按鈕,獲取決策報表 report0 報表塊第 1 行的行高後彈窗顯示: 點選可下載範本:获取第一行单元格行高.frm FVS 視覺化看板:点击获取单元格行高.fvs | |
行動端 | 支援行動端 |
setWidth
方法 | setWidth(width) | 設定儲存格列寬,需要先透過 getColumn(index) 方法獲取到儲存格列。 |
---|---|---|
參數 | width: number | width: 列寬度 |
回傳值 | void | |
範例 | 範例1:若獲取到的表格列物件定義為 col ,將該列列寬設定為 25
範例2:決策報表中將 report0 報表塊第 3 列的列寬設定為 25
範例3:將普通報表中第 3 列的列寬設定為 25
範例4:將 FVS 視覺化看板中的「表格1」組件第 3 列的列寬設定為 45
範例5:決策報表將 report0 報表塊第 1 列的列寬設定為 45 _g().getWidgetByName('report0').getColumn(1).setWidth(45); | |
應用範例 | 點選按鈕,將第 1 列的列寬設定為 45: 點選下載範本:点击修改单元格列宽.frm FVS 視覺化看板:点击修改单元格列宽.fvs 注:該API不支援凍結行的情況 | |
行動端 | 不支援行動端 |
getWidth
方法 | getWidth() | 獲取儲存格列寬,需要先透過 getColumn(index) 方法獲取到儲存格列。 |
---|---|---|
參數 | - | - |
回傳值 | number | 列寬,數字 |
範例 | 範例1:若獲取到的表格列物件定義為 col ,獲取該列的列寬
範例2:獲取決策報表中將 report0 報表塊第 3 列的列寬
範例3:獲取普通報表第 3 列的列寬
範例4:獲取 FVS 視覺化看板中的「表格1」組件第 3 列的列寬
範例5:獲取決策報表 report0 報表塊第 1 列的列寬後彈窗顯示
| |
應用範例 | 點選按鈕,獲取決策報表 report0 報表塊第 3 列的列寬後彈窗顯示: 點選可下載範本:获取第一列单元格列宽.frm FVS 視覺化看板:获取单元格列宽.fvs | |
行動端 | 支援行動端 |
getCell
方法 | getCell(row/col) | 獲取儲存格某一欄上第 row 行的儲存格物件/某一行上第 col 列的儲存格物件,需要先透過 getColumn(index)/getRow(index)方法獲取到儲存格列/行,其中參數為儲存格擴展後的位置 |
---|---|---|
參數 | row:number col:number | row:行號,數字,從 1 開始 col:列號,數字,從 1 開始 |
回傳值 | object | object :儲存格 cell 物件 |
範例 | 範例1:若獲取到的表格列物件定義為 col ,獲取該列上第 1 行的儲存格
範例2:若獲取到的表格行物件定義為 row ,獲取該行上第 1 列的儲存格
範例3:獲取決策報表中 report0 報表塊第 1 行第 1 列的儲存格
或者:
範例4:獲取普通報表中第 1 行第 1 列的儲存格
或者:
範例5:將 FVS 範本中「表格組件」第 2 列第 1 行的儲存格的字體設定為紅色、14 號
範例6:將決策報表中 report0 報表塊第 1 列第 1 行的儲存格的字體設定為紅色、14 號
| |
應用範例 | 點選按鈕,將決策報表中 report0 報表塊 A1 儲存格的字體設定為紅色、14 號: 點選可下載範本:获取列再定位到行后修改单元格样式.frm 點選下載 FVS 範本:获取列再定位到行后修改单元格样式.fvs | |
行動端 | 支援行動端 |
getIndex
方法 | getIndex() | 獲取儲存格行物件/儲存格列物件的位置索引,如擴展後儲存格在第 4 行,則行索引為 4 |
---|---|---|
參數 | - | - |
回傳值 | object | 行索引/列索引,數字,為擴展後的行列 |
範例 | 範例1:若獲取到的表格行物件定義為 row ,傳回該行索引
範例2:若獲取到的表格列物件定義為 col ,獲取該列的列索引
範例3:獲取普通報表中第 1 行的行索引
範例4:獲取 FVS 視覺化看板中的「表格1」組件第 1 行的行索引
範例5:獲取決策報表中 report0 報表塊第 1 行的行索引 var a=_g().getWidgetByName('report0').getRow(1).getIndex(); FR.Msg.alert("提示","第一欄的行索引是"+a ); | |
應用範例 | 點選按鈕,獲取決策報表中將 report0 報表塊第 1 行的行索引: 點選可下載範本:返回行列索引.frm FVS 視覺化看板:获取表格行索引.fvs | |
行動端 | 支援行動端 |
setStyle
方法 | setStyle(opts) | 設定儲存格行/列物件的樣式。在行列物件上使用時,需要先透過 getRow(index)/getColumn(index) 方法獲取到儲存格行/列。 |
---|---|---|
參數 | opts: Object { fontFamily: String fontSize: number fontWeight: String color: String ........ } | opts: 儲存格式屬性,如邊框、背景、字體顏色等,詳細可查看:樣式屬性style |
回傳值 | - | - |
範例 | 範例1:若獲取到的儲存格行物件定義為 row ,設定該儲存格的樣式為字體顏色紅色、字號14 號
範例2:將決策報表中 report0 報表塊第一行儲存格的樣式設定為字體顏色紅色、字號14 號
範例3:將普通報表第一行儲存格的樣式設定為字體顏色紅色、字號14 號
範例4:將 FVS 視覺化看板中的「表格1」組件第一欄儲存格的樣式設定為字體顏色紅色、字號 20 號
範例5:將決策報表中 report0 報表塊第一欄儲存格的樣式設定為字體顏色紅色、字號14 號
| |
應用範例 | 點選按鈕,將決策報表中 report0 報表塊的第一欄儲存格的字體都設定為紅色、14 號: 點選可下載範本:获取列后修改列单元格样式.frm FVS 視覺化看板:修改列单元格样式.fvs | |
行動端 | 支援行動端 |
showToolTip
方法 | showToolTip(opts) | 給報表塊儲存格行/列新增提示。在行列物件上使用時,需要先透過 getRow(index)/getColumn(index) 方法獲取到儲存格行/列。 |
---|---|---|
參數 | opts: Object { show: boolean, content: { text: string, // 文字 image: string, // 圖片 header: string // 標題 } style: { } } 注:普通報表不支援 header 和 image 參數 | opts: 彈窗選項,是個物件 1)show:是否會出現彈窗,布林型,true 為出現,false 為不出現 2)content:可選欄位,不指定即為顯示文字,內容為儲存格中的值
也可以將圖片放置在報表工程目錄 %FR_HOME%\webapps\webroot 下,透過URL 存取。如: http://localhost:8075/webroot/11.jpg
3)style: 可選欄位,不指定則為預設樣式,支援的樣式可參考:儲存格樣式屬性style |
回傳值 | - | - |
範例 | 範例1:將獲取到的報表塊行物件定義為 row,為行物件設定一個標題為“提示”,內容為紅色“地區銷售資料”字樣的提示框:
範例2:給決策報表中 report0 報表塊的第 1 行儲存格設定一個標題為“提示”,內容為紅色“地區銷售資料”字樣的提示框:
範例3:給決策報表中 report0 報表塊第 1 列儲存格設定一個標題為“提示”,內容為網頁圖片帆軟 LOG 的提示框:
範例4:給普通報表第一欄儲存格設定一個標題為“提示”,內容為網頁圖片帆軟 LOG 的提示框:
範例5:給 FVS 視覺化看板中的「表格1」組件第 1 列儲存格設定一個標題為“提示”,內容為網頁圖片帆軟 LOG 的提示框
| |
應用範例 | 給決策報表中 report0 報表塊第一行設定一個標題為“提示”,內容為紅色“地區銷售資料”字樣的提示框: 點選可下載範本:鼠标悬浮单元格行文字提示.frm FVS 視覺化看板:鼠标悬浮单元格行文字提示.fvs | |
行動端 | 不支援行動端 |