PictureElement

摘要

用于访问图片属性,从而在页面布局中重新定位图片并获取和设置其数据源。

说明

PictureElement 对象代表已插入到页面布局中的栅格或影像。Layout 对象上的 listElements 方法将返回页面布局元素对象的 Python 列表。随后需要遍历列表中的每个项目,或指定一个索引号以引用具体的页面元素对象。要仅返回 PictureElements 列表,则对 element_type 参数使用 PICTURE_ELEMENT 常量。wildcard 还可以根据元素name进一步优化搜索。

X、Y 元素位置取决于元素的锚位置。

PictureElement 对象所具有的 sourceImage 属性,可用于读取原始源或指定新图片源位置。如果您计划用不同大小和纵横比的图片替换原有图片,则应创建原始图片,其中的高度和宽度代表所有其他图片在页面布局中占据的范围。使用 sourceImage 属性替换某个图片且新图片具有不同的横纵比时,将使用最长边调整新图片,使其适应原始图片区域。替换的图片绝不会超过原始定义的尺寸。您最好还设置锚点位置,以便所有新图片都相对于该位置进行调整。如果不希望图片偏斜,请确保选中保留纵横比选项。

注:

图片始终存储在项目中。sourceImage 属性显示插入图片时的原始源位置。将文件从磁盘中移除后图片将继续显示在布局中。

属性

属性说明数据类型
elementHeight
(可读写)

元素的高度(以页面单位计)。分配或报告的单位为页面单位。

Double
elementPositionX
(可读写)

图片元素的锚点位置的 x 位置。分配或报告的单位为页面单位。

Double
elementPositionY
(可读写)

图片元素的锚点位置的 y 位置。分配或报告的单位为页面单位。

Double
elementRotation
(可读写)

元素的旋转角度(以度为单位)。正值将使方向顺时针旋转,负值将使方向逆时针旋转。

Double
elementWidth
(可读写)

元素的宽度(以页面单位计)。分配或报告的单位为页面单位。

Double
name
(可读写)

元素的名称。

String
sourceImage
(可读写)

表示到图片数据源的文本字符串。

String
type
(只读)

返回 PICTURE_ELEMENT

String
visible
(可读写)

如果元素在布局上可见,则返回 True。进行打印或导出前,您可以切换元素的可见性,而不是从页面中移除不需要的对象。

Boolean

代码示例

PictureElement 示例

以下脚本将按名称查找图片,并将其数据源设置为新路径。

import arcpy
aprx = arcpy.mp.ArcGISProject(r"C:\Projects\YosemiteNP\Yosemite.aprx")
lyt = aprx.listLayouts("Main Attractions")[0]
pic = lyt.listElements("PICTURE_ELEMENT", "logo")[0]
pic.sourceImage = r"C:\Projects\YosemiteNP\yoslogo.png"
aprx.save()
del aprx