1. 概述
1.1 版本
| 报表服务器版本 | 功能变动 |
|---|---|
| 11.0 | - |
| 11.0.4 | 支持 jpg、png、bmp 常用格式的图片，分别缓存为该格式下的文件，不会出现导出文件时体积暴涨的情况 |
| 11.0.18 | 优化 ImageWithSuffix 对象占用两倍内存问题，优化后占用内存缩小为原来的一半 |
1.2 函数作用
TOIMAGE 函数用于在报表中显示某一路径下的图片。支持 jpg、png、bmp 常用格式的图片，图片可以存储在本地磁盘，也可以存储在远程服务器，也可以为网页中图片。
1.3 函数解释
TOIMAGE(path)，显示指定路径下的图片。此处默认开启了图片缓存功能以加速报表的生成.如不需要缓存，请在参数后面追加值FALSE。
| 参数 | 含义 | 参数格式 |
|---|---|---|
| path | 图片路径，不可省略 | "F:/FineReport_11.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.5 注意事项
1）使用 TOIMAGE 函数显示单元格图片的模板，在选择菜单栏「文件>输出>模板（内置数据）」时，图片不会伴随输出。
2）若使用 TOIMAGE 函数的单元格属性设置了「样式>段间距」，那么导出或打印报表时，设置的「段间距」不生效。
3）使用 TOIMAGE 函数返回的图片，「图片布局」为「默认」。可以在「单元格属性>样式>对齐>图片布局」处选择其他布局方式。
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）若图片存储在本地磁盘 E 盘，路径为：E:/图片/logo-fanruan.png，将图片路径存在数据库表中，如下图所示：
2）将字段「path」拖到报表单元格中，右侧单元格属性选择「高级」，在「显示值」位置，输入公式 TOIMAGE($$$) ，$$$ 表示当前单元格值，步骤如下图所示：
3）若存储在数据库的图片路径不完整，需要补全路径使图片显示。
如上述 E 盘中的图片，若在数据库中存储的路径为 ：logo-fanruan.png ，需要将「显示值」的公式修改为 :TOIMAGE("E:/图片/"+$$$) 。
注：如果用户数据库服务器和报表应用服务器分开的话，图片应该存放在报表应用服务器上，而不是数据库服务器上。
2.3 调整图片布局
TOIMAGE 公式引用图片支持调整图片布局，选中单元格，在右侧属性面板中选择「单元格属性>样式>自定义>对齐」，在「高级>图片布局」中即可调整图片布局方式，如下图所示：
不同布局方式的显示效果如下图所示，默认的布局显示与平铺相同：
上一篇：其他函数概述
