ListDataFrames (arcpy.mapping)

Краткая информация

Возвращает список объектов Python DataFrame, находящихся в одном документе карты (.mxd).

Обсуждение

ListDataFrames всегда возвращает объект списка Python, даже если возвращается только один фрейм данных. Чтобы вернуть объект DataFrame в перечне необходимо указать значение индекса (например, df = arcpy.mapping.ListDataFrames(mxd)[0]). For зацикливает список, что обеспечивает простой механизм итерации каждого элемента списка (например, for df in arcpy.mapping.ListDataFrames(mxd):).

Групповые символы не чувствительны к регистру. строка групповых символов для "la*" возвращает фрейм данных с именем Layers.

Возможно наличие одинаковых имен для фреймов данных в документе карты. В этом случае можно использовать другие свойства для изоляции определенного фрейма данных. Для этого можно использовать такие свойства фрейма данных как разрешения или описание. В лучшем случае все фреймы данных должны иметь уникальные имена.

Синтаксис

ListDataFrames (map_document, {wildcard})

Параметр	Объяснение	Тип данных
map_document	Переменная, которая ссылается на объект MapDocument.	MapDocument
wildcard	Для наложения ограничения на результаты можно использовать сочетание звездочек (*) и символов. (Значение по умолчанию — None)	String

Возвращено значение

Тип данных	Объяснение
DataFrame	Список Python объектов DataFrame.

Пример кода

DataFrame, пример:

Этот скрипт выполняет поиск фрейма данных по имени Transportation и назначает соответствующие значения для масштаба и поворота.

import arcpy
mxd = arcpy.mapping.MapDocument(r"C:\Project\Project.mxd")
for df in arcpy.mapping.ListDataFrames(mxd, "t*"):
    if df.name.lower == "transportation":
        df.scale = 24000
        df.rotation = 5.5
mxd.saveACopy(r"C:\Project\Project2.mxd")
del mxd