PictureElement

摘要

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

说明

PictureElement 对象代表已插入到页面布局中的栅格或影像。ListLayoutElements 函数将返回页面布局元素对象的 Python 列表。随后遍历列表中的每个项目，或指定一个索引号以引用具体的页面元素对象。要返回一个只包含 PictureElements 的列表，应对 element_type 参数使用 PICTURE_ELEMENT 常量。可使用通配符根据元素名称优化搜索过程。

建议您为每个页面布局元素赋予唯一的名称，以便在 Python 中进行区分。X 和 Y 值以元素的锚点位置为基础，可通过 ArcMap 中元素属性对话框的大小和位置选项卡进行设置。

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

属性

属性	说明	数据类型
elementHeight （可读写）	The height of the element in page units. The units assigned or reported are in page units.	Double
elementPositionX （可读写）	The x location of the data frame element's anchor position. The units assigned or reported are in page units.	Double
elementPositionY （可读写）	The y location of the data frame element's anchor position. The units assigned or reported are in page units.	Double
elementWidth （可读写）	The width of the element in page units. The units assigned or reported are in page units.	Double
name （可读写）	The name of the element.	String
sourceImage （可读写）	A text string that represents the path to the image data source.	String
type （只读）	Returns the element type for any given page layout element. DATAFRAME_ELEMENT —Data frame element GRAPHIC_ELEMENT —Graphic element LEGEND_ELEMENT —Legend element MAPSURROUND_ELEMENT —Map surround element PICTURE_ELEMENT —Picture element TEXT_ELEMENT —Text element	String

代码示例

PictureElement 示例 1

以下脚本将按名称查找影像，并将其数据源设置为新路径。

import arcpy
mxd = arcpy.mapping.MapDocument(r"C:\Project\Project.mxd")
for elm in arcpy.mapping.ListLayoutElements(mxd, "PICTURE_ELEMENT"):
    if elm.name == "Photo":
        elm.sourceImage = r"C:\Project\Data\NewPhoto.bmp"
mxd.save()
del mxd

PictureElement 示例 2

以下脚本显示在启用了“数据驱动页面”的地图文档中，各页面上的不同图片如何进行切换。每个页面上有不同的图片。这些图片命名为 Photo1.png、Photo2.png、Photo3.png 等，以匹配相应的页码。

import arcpy
mxd = arcpy.mapping.MapDocument(r"C:\Project\Project.mxd")
pict = arcpy.mapping.ListLayoutElements(mxd, "PICTURE_ELEMENT", "photo")[0]
for pageNum in range(1, mxd.dataDrivenPages.pageCount + 1):
    mxd.dataDrivenPages.currentPageID = pageNum
    pict.sourceImage = r"C:\Project\Data\Photo{0}.png".format(pageNum)
    print("Exporting page {0} of {1}"
          .format(mxd.dataDrivenPages.currentPageID,
                  mxd.dataDrivenPages.pageCount))
    arcpy.mapping.ExportToPDF(mxd, r"C:\Project\Page{0}.pdf".format(pageNum))
del mxd