FindByKey method (MapDoc)

Ищет объект активного слоя по ключу и отмечает его на карте мигающей рамкой.

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

MapDoc

Синтаксис:

Visual Basic:

Sub FindByKey(Key As Long)

Key - ID искомого объекта.

Описание:

Объект ищется только в активном слое карты (Layers.Active). Найденный объект становится текущим: свойство слоя CurrentID получает его ID, а в окне карты вокруг объекта мигает рамка. Вид карты при этом не перемещается: если объект лежит за пределами окна, отметки не видно, и показать его можно, например, методом вида SetCenter.

Если объекта с таким ключом в активном слое нет, CurrentID становится равным -1, а в VBScript возникает исключение с кодом 520 («Элемент с указанным ключом не найден»). В python исключения нет - результат проверяют по CurrentID.

Пример:

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

Visual Basic:

Sub MapDoc_FindByKey
'Берем рабочую карту и ее активный слой
Set Doc = Zulu.ActiveMapDoc
Set L = Doc.Layers.Active
Key = L.ElementKeys.Item(1)
'Если ключа в слое нет, возникает исключение 520
On Error Resume Next
Doc.FindByKey Key
If Err.Number <> 0 Then
  MsgBox "Объект " & Key & " не найден: " & Err.Description
Else
  MsgBox "Объект " & Key & " отмечен на карте, CurrentID = " & L.CurrentID
End If
End Sub

Python:

import zulu

def Macro_MapDoc_FindByKey():
    # Берем рабочую карту и ее активный слой
    doc = zulu.App.ActiveMapDoc
    L = doc.Layers.Active
    key = L.ElementKeys.Item(1)
    # Исключения в python нет - результат проверяем по CurrentID
    doc.FindByKey(key)
    if L.CurrentID == key:
        print("Объект", key, "отмечен на карте")
    else:
        print("Объект", key, "не найден")