StyleItem (arcpy.mapping)
Резюме
Обеспечивает доступ к свойствам класса StyleItem.
Обсуждение
Символы, которые вы выбираете для отображения объектов, элементов или графики на вашей карте, хранятся в файлах стилей (.style). Диалоговое окно Менеджер стилей (Style Manager) используется для просмотра, создания и изменения стилей и их содержимого. Стили распределены по категориям или по папкам, например, Цвета (Colors), Элементы легенды (Legend Items), Символы маркеров (Marker Symbols) и Масштабные линейки (Scale Bars). Отдельные элементы стилей хранятся в категории или в папке с соответствующим именем. Например, в папке Элементы легенды (Legend Items) имеется несколько различных стилей, использующихся для элементов легенды, каждый из них имеет собственный формат, размер и тип шрифта для элементов, отображающихся в легенде.
Класс StyleItem используется как основной метод arcpy.mapping, обеспечивающий возможность обновления стилей элементов легенды и задания пользовательских параметров. При работе с интерфейсом, когда вы добавляете новый слой в таблицу содержания, и он автоматически добавляется в легенду, применяется стиль по умолчанию. Модуль arcpy.mapping позволяет обновлять отдельные стили элементов легенды с помощью LegendElement на странице компоновки. Это можно сделать, используя следующий рабочий процесс.
- Создайте собственный элемент стиля легенды с помощью Менеджера стилей (Style Manager).
- Создайте ссылку на этот элемент стиля с помощью функции ListStyleItems.
- Создайте ссылку на элемент легенды с помощью функции ListLayoutElements.
- Обновите определенный элемент стиля легенды с помощью метода updateItem класса LegendElement.
Свойства
| Свойство | Объяснение | Тип данных |
| itemName (только чтение) |
Строка, которая отображает имя элемента так, как оно выглядит в диалоговом окне Менеджер стилей (Style Manager). | String |
| itemCategory (только чтение) |
Строка, которая отображает категорию элемента так, как она выглядит в диалоговом окне Менеджер стилей (Style Manager). Категории используются для группировки символов в стиле. | String |
| styleFolderName (только чтение) |
Строка, отображающая имя папки, в которой хранится StyleItem, например, Legend Items. Определение styleFolderName позволяет установить тип объекта style, на который вы ссылаетесь. | String |
Пример кода
Следующий скрипт использует рабочий процесс, описанный выше, и обновляет стиль элемента легенды. В первый фрейм данных документа карты добавляется слой, а стиль элемента легенды обновляется с использованием пользовательского стиля NewDefaultLegendStyle. Пользовательский файл .style сохранен в папке профиля пользователя.
import arcpy
mxd = arcpy.mapping.MapDocument(r"C:\Project\Project.mxd")
df = arcpy.mapping.ListDataFrames(mxd)[0]
lyrFile = arcpy.mapping.Layer(r"C:\Project\Data\Rivers.lyr")
arcpy.mapping.AddLayer(df, lyrFile, "TOP")
styleItem = arcpy.mapping.ListStyleItems("USER_STYLE", "Legend Items", "NewDefaultLegendStyle")[0]
legend = arcpy.mapping.ListLayoutElements(mxd, "LEGEND_ELEMENT")[0]
legend.updateItem(lyrFile, styleItem)
del mxd