ModifyByKeys method (Selection)

Изменяет группу по коллекции ключей ElementKeys.

Применяется к:

Selection

Синтаксис:

Visual Basic:

Sub ModifyByKeys(What As eModifySelection, Keys As ElementKeys)

What - способ изменения: 1 (eSelCreate) - группа создается заново из этих ключей, 2 (eSelAppend) - ключи добавляются, 3 (eSelExclude) - ключи исключаются.

Keys - коллекция ключей.

Описание:

Коллекцию ключей дают, например, Layer.ElementKeys, отбор ElementKeys.SelectByType и результаты поиска. Ключи не проверяются: группа принимает и ключи, которых в ее слое нет. Пустая коллекция группу не меняет, в том числе при What = 1 - в группе остаются прежние объекты; при других значениях What группа тоже не меняется. Массив, число или объект другого класса вместо коллекции вызывают ошибку «Type mismatch» (в Python - TypeError).

В Python это основной способ передать группе сразу несколько ключей: метод ModifyEx там принимает только одиночный ключ.

Пример:

Пример выделяет в активном слое все объекты первого символьного типа.

Visual Basic:

Sub Selection_ModifyByKeys
Const eSelCreate = 1
'Берем активный слой карты и его группу
Set L = Zulu.ActiveMapDoc.Layers.Active
Set S = L.Selection
'Ищем первый символьный тип (GraphicType = 1)
Set OTs = L.ObjectTypes
T = -1
For i = 0 To OTs.Count - 1
  If OTs.GetItemByIndex(i).GraphicType = 1 And T = -1 Then T = OTs.GetItemByIndex(i).Id
Next
If T = -1 Then
  MsgBox "В слое нет символьного типа"
Else
  'Ключи объектов этого типа в любом режиме
  Set K = L.ElementKeys.SelectByType(T, 0)
  S.ModifyByKeys eSelCreate, K
  MsgBox "Тип " & T & ": в группе " & S.ElementKeys.Count & " объектов"
  S.Clear
End If
End Sub

Python:

import zulu

eSelCreate = 1

def Macro_Selection_ModifyByKeys():
    # Берем активный слой карты и его группу
    L = zulu.App.ActiveMapDoc.Layers.Active
    S = L.Selection
    # Ищем первый символьный тип (GraphicType = 1)
    OTs = L.ObjectTypes
    ids = [OTs.GetItemByIndex(i).Id for i in range(OTs.Count) if OTs.GetItemByIndex(i).GraphicType == 1]
    if not ids:
        print("В слое нет символьного типа")
        return
    # Ключи объектов этого типа в любом режиме
    K = L.ElementKeys.SelectByType(ids[0], 0)
    S.ModifyByKeys(eSelCreate, K)
    print("Тип", ids[0], ": в группе", S.ElementKeys.Count, "объектов")
    S.Clear()