ModifyEx method (Selection)

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

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

Selection

Синтаксис:

Visual Basic:

Sub ModifyEx(What As eModifySelection, vKeys As Variant)

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

vKeys - ключи.

Описание:

В Visual Basic ключи можно передать:

  • одним числом - и значением, и переменной;

  • массивом чисел, например Array(5, 7, 9);

  • коллекцией ElementKeys;

  • набором данных ZbDataset - ключами считаются значения первого столбца, например результата запроса SELECT Sys FROM ... (Layer.ExecSQL).

Строка, пустое значение, пустой массив и объект другого класса группу не меняют и ошибки не вызывают, в том числе при What = 1 - в группе остаются прежние объекты; другие значения What группу тоже не меняют. Ключи не проверяются: группа принимает и ключи, которых в ее слое нет.

В Python метод принимает только одиночный ключ; список, кортеж, коллекцию ElementKeys и набор данных он без ошибки пропускает, не меняя группу. Несколько ключей в Python передают методом ModifyByKeys.

Пример:

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

Visual Basic:

Sub Selection_ModifyEx
Const eSelCreate = 1
Const eSelExclude = 3
'Берем активный слой карты и его группу
Set L = Zulu.ActiveMapDoc.Layers.Active
Set S = L.Selection
Set K = L.ElementKeys
'Группа из первых трех объектов - массивом
S.ModifyEx eSelCreate, Array(K.Item(1), K.Item(2), K.Item(3))
N = S.ElementKeys.Count
'Исключаем первый объект - одним ключом
S.ModifyEx eSelExclude, K.Item(1)
MsgBox "В группе было " & N & ", стало " & S.ElementKeys.Count
S.Clear
End Sub

Python:

import zulu

eSelAppend = 2
eSelExclude = 3

def Macro_Selection_ModifyEx():
    # Берем активный слой карты и его группу
    L = zulu.App.ActiveMapDoc.Layers.Active
    S = L.Selection
    K = L.ElementKeys
    S.Clear()
    # В Python метод принимает только одиночный ключ
    for i in (1, 2, 3):
        S.ModifyEx(eSelAppend, K.Item(i))
    n = S.ElementKeys.Count
    # Исключаем первый объект
    S.ModifyEx(eSelExclude, K.Item(1))
    print("В группе было", n, ", стало", S.ElementKeys.Count)
    S.Clear()