Skip to main content

applyStyleItem

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

LegendItem обеспечивает доступ к информации на уровне элемента легенды в LegendElement.

Обсуждение

Свойство items класса LegendElement возвращает список объектов LegendItem. Для каждого элемента легенды вы можете изменить такие свойства, как arrangement, patchHeight и его статус visible. Типичный рабочий процесс состоит в том, чтобы итерировать список элементов, определять интересующий элемент по его свойству name, а затем вносить соответствующие изменения.

Примечание:

Свойства, указываемая для класса LegendItem, не применяются ко всем типам средств визуализации. Важно поймать эти исключения при необходимости.

Синтаксис

applyStyleItem()

Свойства

Имя Объяснение Тип данных

arrangement

(Чтение / Запись)

Строка, определяющая выравнивание элементов легенды. Ниже приведен действительный список значений:

  • PatchLabelDescription—Образец, надпись, описание

  • PatchDescriptionLabel—Образец, описание, надпись

  • LabelPatchDescription—Надпись, образец, описание

  • LabelDescriptionPatch—Надпись, описание, образец

  • DescriptionPatchLabel—Описание, образец, надпись

  • DescriptionLabelPatch—Описание, надпись, образец

String

column

(Чтение / Запись)

Положение столбца для элемента легенды. Свойство столбца применяется только к легендам, использующим стратегию расположения ManualColumns.

Long

name

(Только для чтения)

Возвращает имя элемента легенды. Имя элемента легенды задается путем изменения имени слоя.

String

patchHeight

(Чтение / Запись)

Высота образца элемента легенды. Единицы указаны в пунктах.

Double

patchWidth

(Чтение / Запись)

Ширина образца элемента легенды. Единицы указаны в пунктах.

Double

showFeatureCount

(Чтение / Запись)

Логическое значение, которое определяет, размещается ли количество объектов рядом с текстом элемента легенды. Отображаемое значение зависит от настройки showVisibleFeatures.

Boolean

showVisibleFeatures

(Чтение / Запись)

Логическое значение, которое определяет, отображаются ли для элемента легенды все значения или только те значения, которые отображаются в видимом экстенте.

Boolean

type

(Только для чтения)

Возвращает значение LEGEND_ITEM.

String

visible

(Чтение / Запись)

Возвращает True, если элемент легенды виден в легенде.

Boolean

Методы

applyStyleItem(style_item)

Применяет StyleItem к LegendItem.

Имя Объяснение Тип данных

style_item

A reference to a StyleItem in a project.

StyleItem

Пример кода

Пример LegendItem

Следующий скрипт итерирует все элементы легенды в легенде. Он устанавливает patchHeight и patchWidth для всех элементов легенды, затем устанавливает showVisibleFeatures для определенного элемента легенды.

p = arcpy.mp.ArcGISProject('current')
lyt = p.listLayouts('Layout')[0]
leg = lyt.listElements('LEGEND_ELEMENT')[0]

#Change the patch size for all legend items
#only display features in the visible map frame extent
for itm in leg.items:
  itm.patchHeight = 15
  itm.patchWidth = 30
  if itm.name == 'Geological Types':
    itm.showVisibleFeatures = True