1. 概述
1.1 函數作用
TOIMAGE 函數用於在報表中顯示某一路徑下的圖片。支持 jpg、png、bmp 常用格式的圖片，圖片可以存儲在本地磁盤，也可以存儲在遠程服務器，也可以爲網頁中圖片。
1.2 函數解釋
TOIMAGE(path,cache,width,height)
| 參數 | 含義 | 參數格式 |
|---|---|---|
| path | 圖片路徑，不可省略 | "F:/FineReport_10.0/webroot/logo.png" 注：斜杠必須爲 / |
| cache | 是否開啓圖片緩存功能，可省略，省略默認開啓 | 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.3 注意事項
1）使用 TOIMAGE 函數顯示單元格圖片的模板，在選擇菜單欄「文件>輸出>模板（内置數據）」時，圖片不會伴随輸出。
2）若使用 TOIMAGE 函數的單元格屬性設置了「樣式>段間距」，那麽導出或打印報表時，設置的「段間距」不生效。
3）使用 TOIMAGE 函數返回的圖片，「圖片布局」爲「默認」。可以在「單元格屬性>樣式>對齊>圖片布局」處選擇其他布局方式。
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") |
注：報表服務器 webroot 爲遠程服務器時，設計器必須切換到對應遠程服務器工作目錄下。
2.2 引用數據庫中的字段
1）若圖片存儲在本地磁盤 E 盤，路徑爲：E:/圖片/logo-fanruan.png，将圖片路徑存在數據庫表中，如下圖所示：
2）将字段「path」拖到報表單元格中，右側單元格屬性選擇「高級」，在「顯示值」位置，輸入公式 TOIMAGE($$$) ，$$$ 表示當前單元格值，步驟如下圖所示：
3）若存儲在數據庫的圖片路徑不完整，需要補全路徑使圖片顯示。
如上述 E 盤中的圖片，若在數據庫中存儲的路徑爲 ：logo-fanruan.png ，需要将「顯示值」的公式修改爲 :TOIMAGE("E:/圖片/"+$$$) 。
注：如果用戶數據庫服務器和報表應用服務器分開的話，圖片應該存放在報表應用服務器上，而不是數據庫服務器上。
