历史版本28 :TOIMAGE函数显示单元格图片 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 版本

报表服务器版本功能变动
11-
11.0.4支持 jpg、png、bmp 常用格式的图片,分别缓存为该格式下的文件,不会出现导出文件时体积暴涨的情况

1.2 函数作用

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)若图片存储在本地磁盘 E 盘,路径为:E:/图片/logo-fanruan.png,将图片路径存在数据库表中,如下图所示:

image.png

2)将字段「path」拖到报表单元格中,右侧单元格属性选择「高级」,在「显示值」位置,输入公式 TOIMAGE($$$) ,$$$ 表示当前单元格值,步骤如下图所示:

3)若存储在数据库的图片路径不完整,需要补全路径使图片显示。

如上述 E 盘中的图片,若在数据库中存储的路径为 :logo-fanruan.png ,需要将「显示值」的公式修改为 :TOIMAGE("E:/图片/"+$$$)  。

注:如果用户数据库服务器和报表应用服务器分开的话,图片应该存放在报表应用服务器上,而不是数据库服务器上。