1. 概述编辑
1.1 函数作用
Toimage 函数用于在报表中显示某一路径下的图片,显示的图片可以存储在部署报表工程的服务器上,也可以为网页图片。
注1:Toimag 函数作用为显示某一路径下的图片,并不代表将图片上传在模板中,所以将模板导出时图片不会存储在模板中。
注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,图片路径存在数据库表中,如下图所示:
1)新建模板,新建数据集 ds1 ,SQL 语句为 select * from path ,如下图所示:
2)将图片路径所在字段「ds1.path」列拖到 A1 单元格中,在右侧「单元格属性」>「高级」>「显示值」位置,输入公式 :
Toimage($$$) ,如下图所示:
注:如果数据库存储的路径不完整,可以通过公式补全路径,如数据库存储的路径:"图片\logo-fanruan.png" 不完整,使用公式 Toimage("E:\"+$$$) 补全。
3)点击 B2 单元格,输入公式 toimage("E:/图片/logo-fanruan.png"),如下图所示:
4)保存模板,点击「分页预览」,预览效果如下图所示: