Краткая информация
Возвращает список объектов 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