目录:
1. 概述编辑
1.1.函数作用
Toimage函数用于在报表中显示某一路径下的图片，图片可以存储在本地电脑，也可以存储在远端服务器，也可以为网页中图片。
注1：使用了toimag函数的模板导出时，用Toimage函数显示的单元格图片不会伴随导出。
注2：Toimage()公式，支持 jpg、png、bmp 常用格式的图片。
注3：用Toimage函数显示单元格图片，单元格设置了段间距，导出 PDF 或打印报表时，设置的「段间距」不生效。
1.2.函数解释
TOIMAGE(patch,cache,width,height)
| 参数 | 含义 | 参数格式 |
|---|---|---|
| path | 图片路径，不可省略 | "F:/FineReport_10.0/webroot/logo.png" 或 "F:\\FineReport_10.0\\webroot\\logo.png" |
| cache | 是否开启图片缓存功能，可以省略，省略默认开启 | true 开启，false 关闭 |
| width | 图片宽度，可以省略，省略默认图片原宽度 | 整数：value 图片宽度像素 百分比："value" 图片宽度缩放比 |
| height | 图片高度，可以省略，省略默认图片原高度 | 整数：value 图片高度像素 百分比："value" 图片高度缩放比 |
注：path 参数必须存在，其余参数根据需要自行选择。
示例：
TOIMAGE("d:/1.jpg")
TOIMAGE("d:/1.jpg",false)
TOIMAGE("d:/1.jpg",true,200,300)
TOIMAGE("d:/1.jpg",true,"50%","200%")
注：使用 toimage 函数返回的图片，「图片布局」为「默认」。可以在「单元格属性」>「对齐」>「图片布局」处选择其他布局方式。
2.图片存储位置编辑
图片可以存储在本地磁盘，也可以存储在远程服务器上。图片存储的位置不同，path 路径的写法不同。
| 图片存储位置 | path 路径 |
|---|---|
| 本地磁盘 | 图片完全路径，如 E:/图片/logo-fanruan.png |
| 报表服务器 webroot 目录下 | 省略工程所在目录的简化路径，如help/logo-fanruan.png |
| 网页中图片 | 图片网络地址，如 https://www.fanruan.com/images/logo-fanruan.png |
示例：
1）现有一图片存储路径为本地电脑 E 盘：E:\图片\logo-fanruan.png，公式为：TOIMAGE("E:/图片/logo-fanruan.png")。
2）现有一图片存储在远程服务器 webroot 目录下时：D:\软件安装区\FineReport_10.0\webapps\webroot\help\logo-fanruan.png，公式为：TOIMAGE("help/logo-fanruan.png") 。
3）显示帆软官网 LOG 图片,公式为：toimage("https://www.fanruan.com/images/logo-fanruan.png")
注1：存储在设计器内置服务器 webroot 文件下的图片也可以简化路径。
注2：显示远程服务器上的图片时，设计器必须切换到对应远程服务器工作目录下。
3.图片路径存储位置编辑
图片路径可以直接在公式中输入，也可以引用存储在数据库的字段。图片路径直接输入参考文档第 2 章，图片路径引用存储在数据库中的字段，参考如下示例。
若图片存在本地电脑 E 盘：E:\图片\logo-fanruan.png，图片路径存在数据库表中,如下图所示：
将路径 「ds1.path」列拖到报表单元格中，右侧单元格属性表选择「高级」，在「显示值」位置，输入公式 :
Toimage($$$) ，便可以显示图片,如下图所示：
若存储在数据库的图片路径不完整，可以补全路径使图片显示。
如图片储存在远程服务器 webroot 目录下时：D:\软件安装区\FineReport_10.0\webapps\webroot\help\logo-fanruan.png ，数据库存储的路径为 ：“help/logo-fanruan.png” ，将自定义公式修改为 :Toimage("D:/软件安装区/FineReport_10.0/webapps/webroot/"+$$$) 补全路径。
注：如果用户数据库服务器和报表应用服务器分开的话，图片应该存放在应用服务器上，而不是数据库服务器上。