20.3 图片函数
图片函数,是在报表中加入图片时,指定图片位置的函数。现在Report30中支持3种图片来源:来自数据集、来自服务器端可访问的文件系统、来自定义工具上传的文件。定义工具上传的文件只需要用户在定义报表时选定本题某个系统支持的图片,所以不需要函数定义。因而Report30提供了2个图片函数,分别用于定义来自数据集的图片和来自服务器端可访问的文件系统的图片。
DBPicture
函数说明:
在报表定义中引入来自数据集的图片。现在只支持图片来自与drm和jdbc数据源。
函数语法:
DBPicture(repository_name, dataentitiy_name, field_name, keys, key_values[, encodeType])
参数说明:
名称 | 数据类型 | 说明 | 是否必需 |
---|---|---|---|
repository_name | 字符串 | DRM或JDBC数据源名 | 是 |
dataentitiy_name | 字符串 | 图片所在表名 | 是 |
field_name | 字符串 | 图片对应字段名 | 是 |
keys | 字符串集合 | 定位图片的键名称列表 | 是 |
key_values | 字符串列表 | 定位图片的键值列表,如果是多个域keys的顺序一一对应 | 是 |
encode_type | 整数 | 图片字段编码类型,0:二进制;1:。BASE64编码。缺省为0 | 否 |
返回值:
PictureDataValue,当前只能用于图片显示,不能嵌套在其他函数内,继续操作。
示例:
从northwind数据源的pictures表中取pic列的图片,定位图片的key是id列,定位的关键值是A2单元格的值:
DBPicture(‘northwind’, ‘pictures’, ‘pic’,list(‘id’),list(A2),0)
FilePicture
函数说明:
在报表定义中引入来自服务器端可访问的文件系统的图片。目前支持包括来自有效的URL,包括HTTP、HTTPS;服务器端绝对路径;服务器端相对于web服务器的相对路径。
函数语法:
FilePicture(url, defaultUrl,codeType)
参数说明:
名称 | 数据类型 | 说明 | 是否必需 |
---|---|---|---|
url | 字符串 | 文件位置,可以是有效的URL,服务器端绝对路径,服务器端相对于web服务器的相对路径。 | 是 |
defaultUrl | 字符串 | 默认的文件位置,格式需与url保持一致,当url指定的文件不存在时,输出默认的图片。 | 是 |
codeType | 整数 | 类型为0代表二进制图片数据,类型为1代表base64编码。默认为0。 | 否 |
返回值:
PictureDataValue,同DBPicture。
示例:
下面将常见URL举例如下:
FilePicture(‘\\pic\test.gif’ , ‘\\pic\test.gif’,0)
FilePicture(‘http://web.neusoft.com/images/enter/pic_2.gif’ , ‘http://web.neusoft.com/images/enter/pic_2.gif’,1)
FilePicture(‘c://aaa/test.gif’ , ‘c://aaa/test.gif’,0)
TextPicture
函数说明:
该函数功能为将文字转成图片,使用在图片单元格中(即设置单元格类型为图片,双击图片单元格打开图片设置向导,在公式中输入=textpicture('文字'))。
生成图片的文字大小、前景色、背景色来自于所在单元格的属性,可以通过调整单元格属性进行调整控制。
函数语法:
TextPicture(text)
参数说明:
名称 | 数据类型 | 说明 | 是否必需 |
---|---|---|---|
text | 字符串 | 待生成图片的文字 | 是 |
返回值:
PictureDataValue,同DBPicture。
示例:
TextPicture('文字')