ArcGISProject

描述

用于访问 ArcGIS Pro 工程方法和属性。大多数地图自动化工作流都需要引用此对象。

说明

ArcGISProject 对象用于访问 ArcGIS Pro 应用程序中找到的众多工程属性和方法。ArcGISProject 对象通常是最先引用的对象（这些对象是在地图自动化脚本中创建的）之一，因为它是访问几乎所有其他 ArcGIS 工程对象的主要入口点。

引用 ArcGISProject 对象后，您可以使用 listMaps 方法访问地图或使用 listLayouts 方法访问布局。引用 Map 对象后，您可以访问 Layer 或 Table对象，或访问 Layout 对象后，您可以访问 GraphicElement、LegendElement、MapFrame、MapSurroundElement、pictureElement 和 TextElement 等布局元素。您可以从这些对象访问工程中的其他对象。ArcGISProject 对象还可以用于管理工程设置，如 defaultGeodatabase 和 defaultToolbox。

importDocument 方法允许您将地图文档 (.mxd)、globe 文档 (.3dd) 和 scene 文档 (.sxd) 导入到工程中。此操作提供了用于将这些文档类型自动转换为 ArcGIS Pro 工程的机制。importDocument 方法还允许您将地图文件 (.mapx)、布局文件 (.pagx) 或报表文件 (.rptx) 导入到现有工程中。

activeMap 属性用于在应用程序内部执行的脚本，例如在 Python 窗格中运行的脚本，或与使用基于活动视图提供信息的验证脚本的脚本工具相关联的脚本。例如，如果地图视图已打开，则会返回相关联的地图。如果布局视图已打开，则会返回与布局上活动地图框相关联的地图。当脚本在应用程序外部运行时，该属性将始终返回 None 值，因为视图仅在应用程序打开时才会相关。

属性

方法概述

方法

importDocument (document_path, {include_layout}, {reuse_existing_maps})

此方法一次只能导入一个文档。要导入多个文档，请对每个文档执行一次此方法。地图文档 (.mxd) 始终具有布局。迁移地图文档时，您可能并不总是想要导入布局。如果是这种情况，请设置 include_layout=False。

listBrokenDataSources ()

返回值

listBrokenDataSources 方法始终返回 Python 列表对象，即使返回一个损坏的图层或表。

listColorRamps ({wildcard})

返回值

在一个工程中，可能会有多个色带使用相同的名称。创作工程时，采用可通过唯一名称轻松进行搜索的色带名称非常重要。索引编号可用于返回一个特定的色带。例如，以下行可以返回列表中的第一个色带对象：cr = aprx.listColorRamps("Black*")[0]。

listLayouts ({wildcard})

返回值

返回 ArcGIS 工程 (.aprx) 中的 Layout 对象的 Python 列表。

listMaps ({wildcard})

返回值

返回 ArcGIS 工程 (.aprx) 中的 Map 对象的 Python 列表。

listReports ({wildcard})

返回值

返回 ArcGIS 工程 (.aprx) 中的报表对象的 Python 列表。

save ()

将更改保存至 ArcGISProject (.aprx)。已保存此项目，同时项目变量继续引用原始 ArcGISProject对象。

saveACopy (file_name)

该方法会创建新输出工程文件，但工程变量继续引用原始 ArcGISProject 对象。并不会复制工程文件夹中的所有内容。

updateConnectionProperties (current_connection_info, new_connection_info, {auto_update_joins_and_relates}, {validate}, {ignore_case})

有关详细说明、参数信息、案例和代码示例，请参阅更新和修复数据源帮助主题。

代码示例

ArcGISProject 示例 1

下面的脚本演示了如何将文档导入到现有 ArcGIS Pro 工程。同时还设置了一些默认工程设置并将结果保存到新文件。

import arcpy
aprx = arcpy.mp.ArcGISProject(r"C:\Projects\blank.aprx")
aprx.importDocument(r"C:\Projects\YosemiteNP\Documents\Yosemite.mxd")
aprx.importDocument(r"C:\Projects\YosemiteNP\Documents\Yosemite_ScenicViews.3dd")
aprx.defaultToolGeoDatabase = r"C:\Projects\YosemiteNP\Data_Vector\YosemiteData.gdb"
aprx.defaultToolbox = r"C:\Projects\YosemiteNP\Analysis\AnalysisTools.tbx"
aprx.saveACopy(r"C:\Projects\YosemiteNP\Yosemite.aprx")

ArcGISProject 示例 2

下面的脚本使用了关键字 current，因此可从 Python 窗口运行此脚本。此脚本打印了工程及其图层中每个地图的名称，以及每个布局的名称及其页面大小。

aprx = arcpy.mp.ArcGISProject("CURRENT")
for m in aprx.listMaps():
    print("Map: " + m.name)
    for lyr in m.listLayers():
        print("  " + lyr.name)
print("Layouts:")
for lyt in aprx.listLayouts():
    print(f"  {lyt.name} ({lyt.pageHeight} x {lyt.pageWidth} {lyt.pageUnits})")

原文地址：https://www.cnblogs.com/gisoracle/p/12313833.html