版本
版本 | 功能變動 |
---|---|
11.0 | 和 10.0 差別:
|
注1:工具欄所有API在普通報表中使用時,要求報表中只有一個工具欄,即頂部工具欄或底部工具欄只存在一個。
注2:以下API不支援在 FVS 視覺化看板中使用。
在使用API前,請務必先仔細閱讀 JS API 相容說明,API預設支援普通報表和決策報表(新版)。
getWidgetByName
方法 | getWidgetByName(name) | 獲取報表工具欄中的按鈕,可結合按鈕的方法使用 |
---|---|---|
參數 | name: string | 按鈕名稱,字串,以下為常用按鈕的名稱
注:export 需使用 11.0.27 及之后版本
|
回傳值 | 按鈕物件 | object |
範例 | 範例1:若獲取到的工具欄物件定義為 toolbar ,獲取工具欄中的郵件按鈕
範例2:普通報表中獲取工具欄中郵件按鈕
| |
應用範例 | 填報成功後,工具欄隱藏「郵件」和「列印」按鈕: 點選可下載範本:工具欄按鈕不可見.cpt | |
行動端 | 不支援行動端 |
getToolbar
在普通報表中使用時,要求報表中只有一個工具欄,即頂部工具欄或底部工具欄只存在一個
普通報表中的使用方法 | getToolbar() | 獲取工具欄物件 |
---|---|---|
參數 | - | - |
回傳值 | 按鈕物件 | object |
範例 | 範例1:獲取到報表物件定義為 report,獲取工具欄物件
範例2:普通報表中獲取工具欄物件
| |
應用範例 | - | |
行動端 | 支援行動端 |
決策報表中的使用方法
決策報表中的使用方法 | getToolbar(index) | 獲取報表塊的工具欄,在工具欄開啟的情況下使用,獲取後使用工具欄API和工具欄按鈕API |
---|---|---|
參數 | index: number | 工具欄位置,數字
|
回傳值 | 工具欄物件 | object |
範例 | 範例1:獲取到報表塊物件定義為 report,獲取頂部工具欄物件
範例2:決策報表中獲取 report0 報表塊的頂部工具欄物件
範例3:決策報表中獲取 report0 報表塊的頂部具欄,並將其隱藏
| |
應用範例 | 點選按鈕隱藏決策報表報表塊的工具欄: 點選可下載範本:點選按鈕隱藏報表塊工具欄.frm | |
行動端 | 支援行動端 |
toolBarFloat
方法 | toolBarFloat(direction) | 設定工具欄顯示位置 |
---|---|---|
參數 | direction: string | 顯示方式,字串
|
回傳值 | void | |
範例 | 範例1:若獲取到的工具欄物件定義為 toolbar ,設定工具欄置中顯示
範例2:普通報表中設定工具欄置中顯示
範例3:決策報表中設定工具欄置中顯示
| |
應用範例 | 普通報表中設定工具欄置中顯示: 點選可下載範本:工具欄置中顯示.cpt | |
行動端 | 不支援行動端 |
setStyle
方法 | setStyle(style) | 修改工具欄大小 |
---|---|---|
參數 | style: { width: number, height: number } | 工具欄大小,json 格式
|
回傳值 | void | |
範例 | 範例1:若獲取到的工具欄物件定義為 toolbar ,修改工具欄大小為長 900,高 60
範例2:普通報表中修改工具欄大小為長 900,高 60
範例3:決策報表中修改工具欄大小為長 900,高 60 _g().getWidgetByName('report0').getToolbar(0).setStyle({ width: 900, height: 60}); | |
應用範例 | 普通報表中設定工具欄長 900,高 60: 點選可下載範本:修改工具欄大小.cpt | |
行動端 | 不支援行動端 |
setVisible
方法 | setVisible(visbility) | 設定工具欄顯示/隱藏 |
---|---|---|
參數 | visbility: boolean | 工具欄是否顯示,布林型
|
回傳值 | void | |
範例 | 範例1:若獲取到的工具欄物件定義為 toolbar ,隱藏工具欄
範例2:普通報表中隱藏報表的工具欄
範例3:決策報表中隱藏報表的工具欄
| |
應用範例 | 普通報表中設定隱藏報表的工具欄: 點選可下載範本:隱藏工具欄.cpt | |
行動端 | 支援行動端 |