LockRedraw method (MapDoc)

Блокирует отрисовку карты, увеличивая на единицу счетчик блокировок.

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

MapDoc

Синтаксис:

Visual Basic:

Function LockRedraw(Flags As Long) As Long

Flags - зарезервирован, должен быть 0.

Описание:

Пока отрисовка заблокирована, изменения карты - видимость и состав слоев, их порядок, настройки - не выводятся в окно. Это позволяет внести несколько изменений и перерисовать карту один раз, а не после каждого из них.

Каждый вызов LockRedraw увеличивает счетчик блокировок на единицу, каждый вызов парного метода UnlockRedraw - уменьшает. Отрисовка разрешается, когда счетчик возвращается к нулю, поэтому UnlockRedraw нужно вызвать столько же раз, сколько LockRedraw. Снятие блокировки само карту не перерисовывает: чтобы показать изменения, вызовите метод Refresh.

Метод возвращает 0: число действующих блокировок по возвращаемому значению не узнать, вызовы нужно учитывать самостоятельно.

Пример:

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

Visual Basic:

Sub MapDoc_LockRedraw
'Берем рабочую карту и имя ее активного слоя
Set Doc = Zulu.ActiveMapDoc
Set A = Doc.Layers.Active
AName = ""
If Not A Is Nothing Then AName = A.Name
'Блокируем отрисовку на время изменений
Doc.LockRedraw 0
For i = 1 To Doc.Layers.Count
  Set L = Doc.Layers.Item(i)
  'Переключаем видимость всех слоев, кроме активного
  If L.Name <> AName Then L.Visible = Not L.Visible
Next
'Снимаем блокировку и перерисовываем карту один раз
Doc.UnlockRedraw 0
Doc.Refresh False
End Sub

Python:

import zulu

def Macro_MapDoc_LockRedraw():
    # Берем рабочую карту и имя ее активного слоя
    doc = zulu.App.ActiveMapDoc
    A = doc.Layers.Active
    aname = A.Name if A is not None else ""
    # Блокируем отрисовку на время изменений
    doc.LockRedraw(0)
    for i in range(1, doc.Layers.Count + 1):
        L = doc.Layers.Item(i)
        # Переключаем видимость всех слоев, кроме активного
        if L.Name != aname:
            L.Visible = not L.Visible
    # Снимаем блокировку и перерисовываем карту один раз
    doc.UnlockRedraw(0)
    doc.Refresh(False)