插入图像工作簿

“插入图像工作簿”活动的属性和配置，该活动将图像插入 Excel 工作簿中的指定单元格锚点，并可选择像素偏移和缩放比例。

UiPath.Excel.Activities.InsertImage

描述

将图像插入 workbook 工作表中，并锚定在单元格上。图像的左上角放置在锚点单元格处，其偏移量为您在图像左侧和图像顶部中设置的值。

备注：

唯一受支持的 Workbook 格式为 .xlsx。

支持以下图像格式：

• PNG
• JPEG
• GIF
• BMP
• TIFF
• WebP
• PCX

项目兼容性

Windows | 跨平台

配置

• 文件- 资源工作簿的完整路径。要切换到本地路径，请选择加号图标，然后选择使用本地文件。当前字段更改为文件（本地路径） ，您可以在其中提供 workbook 的完整路径。
• 图像文件- 要插入的图像的资源文件。要切换到本地路径，请选择加号图标，然后选择使用本地文件。当前字段将更改为“图像（本地路径）” ，您可以在其中提供图像的完整路径。
• 工作表名称- 要在其中插入图像的工作表。如果该工作表不存在，系统会自动创建该工作表。默认值为 Sheet1。
• 单元格- 图像左上角的锚点单元格。默认值为 A1。

使用 workbook

• “工作簿” - 要使用的现有工作簿。

输入

• 图像左侧- 相对于锚点单元格的水平偏移量（以像素为单位）。该值必须为 0 或更大。默认值为 0。
• 图像顶部- 相对于锚点单元格的垂直偏移量（以像素为单位）。该值必须为 0 或更大。默认值为 0。
• 图像宽度- 图像的宽度（以像素为单位）。该值必须为 0 或更大。
• 图像高度- 图像的高度（以像素为单位）。该值必须为 0 或更大。

图像宽度和图像高度值决定图像的缩放方式：

图像宽度	图像高度	结果
未设置	未设置	图像将保持其原始尺寸。
集合	未设置	高度按比例缩放，同时保持纵横比。
未设置	集合	宽度按比例缩放，同时保持纵横比。
集合	集合	图像将使用您设置的确切尺寸。不保留长宽比。

备注：

图像锚定到您在单元格中指定的单元格，从而限制了图像的定位方式：

• “图像左侧”和“图像顶部”的上限为锚点单元格的宽度和高度，因此，大于单元格的偏移量会将图像放置在单元格的边缘。
• 如果调整锚点单元格的大小，图像会随之移动，但会保持自己的尺寸。

该活动不支持在两个单元格之间锚定图像，或将图像放置在独立于任何单元格的固定位置。

选项

• 密码- workbook 的密码（如有必要）。