Previous topicNext topic
Help > 开发指南 > Excel > Excel报表 > 函数 >
FieldPicture图片字段

FIELDPICTURE(图片字段)

FIELDPICTURE 函数从指定的数据字段中检索图片,根据函数参数调整图片大小,并将图片插入到合并文档中的指定位置。

使用以下语法应用 FIELDPICTURE 函数。

FIELDPICTURE(“data_field_name”, “picture_placement”, target_range, [ignore_aspect_ratio], [OffsetX], [OffsetY], [width], [height] )

Data_field_name 是应从中检索图片的数据源字段的名称。

Picture_placement是不区分大小写的字符串,它指定在执行邮件合并后应在生成的文档中插入图片的位置。

Target_range是对应在其中插入图片的单元格区域的引用。

Ignore_aspect_ratio 是一个可选的布尔参数,指示是否应忽略图片的原始纵横比。如果未指定此参数或将其设置为 FALSE,则保留图片的纵横比。

OffsetX 和 OffsetY 是指定与目标范围左侧和顶部的距离(以像素为单位)的值。仅当picture_placement设置为“范围”且ignore_aspect_ratio设置为 FALSE 时,这些参数才会生效。

width和height是指定图片所需宽度和高度(以像素为单位)的值。

结果:在邮件合并模板中,此函数插入括在方括号中的指定数据字段的名称:[data_field_name]。邮件合并完成后,字段图像将显示在生成的文档中,并且该函数返回一个空字符串。如果函数参数不正确或数据源中不存在图像,则返回默认字符串,即方括号中的字段名称。

示例 描述
“=FIELDPICTURE(“Picture”, “range”, A1:B2)” 插入图片并缩放图片以适合指定的单元格范围,从而锁定纵横比。
“=FIELDPICTURE(“Picture”, “range”, A1:B2, FALSE)”
“=FIELDPICTURE(“Picture”, “range”, A1:B2, TRUE)” 插入图片以适合指定的单元格范围,而不锁定纵横比。
“=FIELDPICTURE(“Picture”, “topleft”, A1)” 插入图片,使其左上角位于指定单元格或指定区域的左上角单元格中。
“=FIELDPICTURE(“Picture”, “topleft”, A1:B2)”
“=FIELDPICTURE(“Picture”, “topleft”, A1, 100)” 插入图片,使其左上角位于指定区域的指定单元格或左上角单元格中,并将图像宽度设置为 100 像素而不保留纵横比。
“=FIELDPICTURE(“Picture”, “topleft”, A1:B2, 100)”
“=FIELDPICTURE(“Picture”, “topleft”, A1, 0, 100)” 插入图片,使其左上角位于指定区域的指定单元格或左上角单元格中,并将图像高度设置为 100 像素而不保留纵横比。
“=FIELDPICTURE(“Picture”, “topleft”, A1:B2, 0, 100)”
“=FIELDPICTURE(“Picture”, “topleft”, A1, 120, 100)” 插入图片,使其左上角位于指定区域的指定单元格或左上角单元格中,并将图像宽度设置为 120 像素,将高度设置为 100 像素,而不保留纵横比。
“=FIELDPICTURE(“Picture”, “topleft”, A1:B2, 120, 100)”