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

目录:

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,图片路径存在数据库表中,如下图所示:

image.png

将路径 「ds1.path」列拖到报表单元格中,右侧单元格属性表选择「高级」,在「显示值」位置,输入公式 :

Toimage($$$) ,便可以显示图片,如下图所示:

2020-09-08_17-48-41.jpg

若存储在数据库的图片路径不完整,可以补全路径使图片显示。

如图片储存在远程服务器 webroot 目录下时:D:\软件安装区\FineReport_10.0\webapps\webroot\help\logo-fanruan.png ,数据库存储的路径为 :“help/logo-fanruan.png” ,将自定义公式修改为 :Toimage("D:/软件安装区/FineReport_10.0/webapps/webroot/"+$$$)  补全路径。

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