UpdateLayerTime (arcpy.mapping)

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

Позволяет обновить временные свойства слоя в документе карты (.mxd), извлекая временные свойства из исходного слоя.

Обсуждение

Функция UpdateLayer позволяет только обновлять свойства символов слоя или обновлять ВСЕ свойства слоя, включая свойства времени.

Функция UpdateLayerTime позволяет обновлять только свойства времени для слоя, поэтому она не переопределяет других свойств слоя, которые не следует менять.

Объект source_layer содержит свойства времени, которые необходимо применить. Он может являться файлом слоя на диске или ссылкой на другой слой в документе карты.

Если необходимо обновить свойства слоя в файле слоя, необходимо сначала изменить свойства слоя в документе карты, затем сохранить изменения обратно в файл слоя. См. методы объекта слоя save или saveACopy и пример кода, приведенный ниже.

Синтаксис

UpdateLayerTime (data_frame, update_layer, source_layer)

Параметр	Объяснение	Тип данных
data_frame	Ссылка на объект Фрейм данных (DataFrame), содержащий обновляемый слой.	DataFrame
update_layer	Объект Layer, представляющий существующий слой, который будет обновлен.	Layer
source_layer	Ссылка на объект Слой, содержащий информацию, которая применяется к update_layer.	Layer

Пример кода

1-ый пример UpdateLayerTime

В следующем скрипте обновляются свойства времени слоя с использованием файла слоя. Слой называется temperature и не поддерживает время. Свойства времени в файле слоя, поддерживающем время, будут применены к слою temperature.

import arcpy

mxd = arcpy.mapping.MapDocument(r"C:\Project\Temperature.mxd")
df = arcpy.mapping.ListDataFrames(mxd, "World")[0]
lyr = arcpy.mapping.ListLayers(mxd, "temperature", df)[0]
lyrFile = arcpy.mapping.Layer(r"C:\Project\Data\Time\LayerWithTimeProperties.lyr")
arcpy.mapping.UpdateLayerTime(df, lyr, lyrFile)

# Save changes to a new MXD
mxd.saveACopy(r"C:\Project\Temperature2.mxd")
# Clean up variables
del mxd, df, lyr, lyrFile

2-ой пример UpdateLayerTime

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

import arcpy

mxd = arcpy.mapping.MapDocument(r"C:\Project\Temperature.mxd")
df = arcpy.mapping.ListDataFrames(mxd, "World")[0]
lyr = arcpy.mapping.ListLayers(mxd, "temperature", df)[0]
lyrFile = arcpy.mapping.Layer(r"C:\Project\Data\Time\LayerWithTimeProperties.lyr") #orginally authored in ArcMap
arcpy.mapping.UpdateLayerTime(df, lyr, lyrFile)

# Save changes to a new Layer file
lyr.saveACopy(r"C:\Project\TemperatureWithTime.lyr")
# Clean up variables
del mxd, df, lyr, lyrFile