历史版本17 :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. 图片存储位置编辑

图片存储在部署报表工程的服务器上时,可以存储在报表工程 webroot 目录下,也可以在该服务器的其他位置。

图片存储的位置不同、图片来源不同,path 路径的写法不同。

图片存储位置
path 路径
报表工程 webroot 目录下相对路径:在 webroot 目录下的路径,如 help/logo-fanruan.png
该服务器的其他位置绝对路径:图片所在位置的完整路径,如 E:/图片/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") 。

3. 图片路径存储位置编辑

图片路径可以直接在公式中输入,也可以引用存储在数据库的字段,如下示例。

若图片存在本地电脑 E 盘E:\图片\logo-fanruan.png,图片路径存在数据库表中,如下图所示:

2020-09-09_13-55-47.jpg

1)新建模板,新建数据集 ds1 ,SQL 语句为 select * from  path ,如下图所示:

image.png

2)将图片路径所在字段「ds1.path」列拖到 A1 单元格中,在右侧「单元格属性」>「高级」>「显示值」位置,输入公式 :

Toimage($$$) ,如下图所示:

注:如果数据库存储的路径不完整,可以通过公式补全路径,如数据库存储的路径:"图片\logo-fanruan.png"  不完整,使用公式 Toimage("E:\"+$$$) 补全。

3)点击 B2 单元格,输入公式 toimage("E:/图片/logo-fanruan.png"),如下图所示:

image.png

4)保存模板,点击「分页预览」,预览效果如下图所示:

image.png