《基于ArcGIS的Python编程秘笈（第2版）》——2.4 获取地图文档中的图层列表

本节书摘来自异步社区《基于ArcGIS的Python编程秘笈（第2版）》一书中的第2章，第2.4节,作者： 【美】Eric Pimpler（派普勒） 更多章节内容可以访问云栖社区“异步社区”公众号查看。

2.4　获取地图文档中的图层列表

大多数情况下，获取地图文档中的图层列表是地理处理脚本中的首要工作之一。获取图层列表后，脚本可以循环遍历每个图层并执行某些类型的处理。制图模块中的ListLayers()函数提供获取图层列表的功能。本节将介绍如何获取地图文档中的图层列表。
2.4.1　准备工作
arcpy.mapping模块包含各种列表函数，使用列表函数可以返回图层、数据框、丢失的数据源、表视图和布局元素等对象的列表。在多步骤的处理过程中，通常先使用列表函数返回Python列表，从返回的列表中获取一项或多项元素来做进一步地处理。每个列表函数可返回一个Python列表，Python列表在第1章中介绍过，它是一种用于存储信息的功能非常强大的数据结构。

在多步骤的处理过程中，第1步通常是用列表函数创建列表。脚本随后的处理过程会迭代访问列表中的一项或多项元素。例如，可以先获取地图文档中的图层列表，然后迭代访问每个图层，找到指定名称的图层后，就可以进行进一步的地理处理。

本节将介绍如何从地图文档中获取图层列表。

2.4.2　操作方法
下面按步骤介绍如何获取地图文档中的图层列表。

（1）在ArcMap中打开C:ArcpyBookCh2Crime_Ch2.mxd。

（2）单击ArcMap“标准”工具条上的“Python”按钮。

（3）导入arcpy.mapping模块。

import arcpy.mapping as mapping

（4）引用当前活动的地图文档（Crime_Ch2.mxd），把该引用赋值给变量。

mxd = mapping.MapDocument("CURRENT")

（5）调用ListLayers()函数，传入对地图文档的引用作为参数。

layers = mapping.ListLayers(mxd)

（6）使用for循环，输出地图文档中每个图层的名称。

for lyr in layers:
    print(lyr.name)

（7）运行脚本得到如下输出结果（可以通过查看 C:ArcpyBookcodeCh2GetListLayers.py解决方案文件来检查代码）。

Burglaries in 2009
Crime Density by School District
Bexar County Boundary
Test Performance by School District
Bexar County Boundary
Bexar County Boundary
Texas Counties
School_Districts
Crime Surface
Bexar County Boundary

2.4.3　工作原理
ListLayers()函数用来检索地图文档、数据框或图层文件中的图层列表。在本节中，把对当前地图文档的引用作为参数传递给ListLayers()函数，该函数检索地图文档中所有图层的列表。检索结果存储在名为layers的变量中，layers变量是一个Python列表，Python列表中包含一个或多个图层对象，可以用for循环进行迭代。

2.4.4　拓展
ListLayers()函数是 arcpy.mapping 模块提供的列表函数之一。每种列表函数都返回一个包含某种数据类型的Python列表。例如：ListTableViews()函数返回Table对象列表；ListDataFrames()函数返回 DataFrame 对象列表；ListBookmarks()函数返回地图文档中的书签列表。本书后面的章节会介绍一些其他的列表函数。