Изменяет группу по ключам, заданным числом, массивом, коллекцией или набором данных.
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 SubPython:
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()