1. 概述
1.1 版本
| 報表伺服器版本 | 功能變動 |
|---|---|
| 11.0 | - |
| 11.0.4 | 支援 jpg、png、bmp 常用格式的圖片，分別快取為該格式下的檔案，不會出現匯出檔案時體積暴漲的情況 |
| 11.0.18 | 優化 ImageWithSuffix 物件佔用兩倍記憶體問題，優化後佔用記憶體縮減為原來的一半 |
TOIMAGE 函式用於在報表中顯示某一路徑下的圖片。支援 jpg、png、bmp 常用格式的圖片，圖片可以儲存在本地磁碟，也可以儲存在遠端伺服器，也可以為網頁中圖片。
1.3 函式解譯
TOIMAGE(path)，顯示指定路徑下的圖片。此處預設開啟了圖片快取功能以加速報表的生成.如不需要快取，請在參數後面追加值FALSE。
| 參數 | 含義 | 參數格式 |
|---|---|---|
| path | 圖片路徑，不可省略 | "F:/FineReport_10.0/webroot/logo.png" 注：斜槓必須為 / |
| 布爾 | 是否開啟圖片快取功能，可省略，省略預設開啟 | true 開啟，false 關閉 |
| width | 圖片寬度，可省略，省略預設圖片原寬度 | 整數：圖片寬度像素 百分比：圖片寬度縮放比 |
| height | 圖片高度，可省略，省略預設圖片原高度 | 整數：圖片高度像素 百分比：圖片高度縮放比 |
範例：
TOIMAGE("D:/1.jpg")
TOIMAGE("D:/1.jpg",false)
TOIMAGE("D:/1.jpg",true,200,300)
TOIMAGE("D:/1.jpg",true,"50%","200%")
1.4 注意事項
1）使用 TOIMAGE 函式顯示儲存格圖片的範本，在選擇菜單欄「檔案>匯出>範本（內建資料）」時，圖片不會伴隨匯出。
2）若使用 TOIMAGE 函式的儲存格屬性設定了「樣式>段間距」，那麼匯出或列印報表時，設定的「段間距」不生效。
3）使用 TOIMAGE 函式傳回的圖片，「圖片佈局」為「預設」。可以在「儲存格屬性>樣式>對齊>圖片佈局」處選擇其他佈局方式。
4）不支援模擬計算，模擬計算詳情參見：2.4節。
5）不支援 gif 格式。
2. 應用場景
TOIMAGE 函式中可以直接輸入圖片路徑，也可以引用儲存在資料庫的圖片路徑欄位。
2.1 直接輸入
圖片可以儲存在本地磁碟，也可以儲存在遠端伺服器上。圖片儲存的位置不同，path 路徑的寫法不同。
| 圖片儲存位置 | path 路徑 | 公式 |
|---|---|---|
| 本地磁碟 | 圖片絕對路徑，如 E:/圖片/logo-fanruan.png | TOIMAGE("E:/圖片/logo-fanruan.png") |
報表伺服器 webroot 目錄下 | 省略工程所在目錄的簡化路徑，如 help/logo-fanruan.png | TOIMAGE("help/logo-fanruan.png") |
| 網頁中圖片 | 圖片網路位址，如 https://www.fanruan.com/images/logo-fanruan.png | TOIMAGE("https://www.fanruan.com/images/logo-fanruan.png") 注：顯示網頁中圖片時推薦使用 WEBIMAGE(path) ，可以提升 Web 圖片載入速度。 |
注：報表伺服器 webroot 為遠端伺服器時，設計器必須切換到對應遠端伺服器工作區間下。
2.2 引用資料庫中的欄位
1）若圖片儲存在本地磁碟C盤，路徑為：C:/圖片/logo-fanruan.jpg，將圖片路徑存在資料庫表中，如下圖所示：
2）將欄位「path」拖到報表儲存格中，右側儲存格屬性選擇「進階」，在「顯示值」位置，輸入公式 TOIMAGE($$$) ，$$$ 表示當前儲存格值，步驟如下圖所示：
3）若儲存在資料庫的圖片路徑不完整，需要補全路徑使圖片顯示。
如上述 C 盤中的圖片，若在資料庫中儲存的路徑為 ：logo-fanruan.jpg ，需要將「顯示值」的公式修改為 :TOIMAGE("E:/圖片/"+$$$) 。
注：如果使用者資料庫伺服器和報表應用伺服器分開的話，圖片應該存放在報表應用伺服器上，而不是資料庫伺服器上。
2.3 調整圖片佈局
TOIMAGE 公式引用圖片支援調整圖片佈局，被菜儲存格，在右側屬性面板中選擇「儲存格屬性>樣式>自定義>對齊」，在「進階>圖片佈局」中即可調整圖片佈局方式，如下圖所示：
不同佈局方式的顯示效果如下圖所示，預設佈局顯示與平鋪相同：
