Shift method (Element)

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

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

Element

Синтаксис:

Visual Basic:

Sub Shift(shiftX As Double, shiftY As Double, KeepLink As Boolean, flags As Long)

shiftX, shiftY - сдвиг по осям X и Y в единицах координат слоя.

KeepLink - True: сохранить связь с примыкающими объектами.

flags - флаги (см. ниже); 0 - обычный сдвиг.

Описание:

Все вершины объекта (у символа и текста - точка привязки) сдвигаются на shiftX и shiftY. Если KeepLink равен True, вместе с объектом сдвигаются концы примыкающих к нему объектов - например, концы участков сети у узла, - и связь сохраняется; при False примыкающие объекты остаются на месте. Изменение сразу вносится в слой.

Флаги меняют смысл вызова:

  • 2 - угол символа (Angle) становится равным направлению сдвига: сдвиг по оси Y (на восток) дает 0, по оси X (на север) - 90;

  • 4 - shiftX и shiftY задают не сдвиг, а точку, в которую переносится центральная точка объекта (GetCenter).

Сдвиг без сохранения связей выполняет также метод Move.

Пример:

Пример добавляет за краем данных активного слоя линию и сдвигает ее по оси Y.

Visual Basic:

Sub Element_Shift
'Берем активный слой карты и его габариты
Set L = Zulu.ActiveMapDoc.Layers.Active
Set R = L.GetBoundsRectangle
'Добавляем линию-примитив за краем данных слоя
D = (R.Xmax - R.Xmin) / 10
Set PL = CreateObject("ZuluLib.PolyLine")
PL.AddPoint R.Xmax + D, R.Ymin
PL.AddPoint R.Xmax + 2 * D, R.Ymin
Key = L.AddPolyLine(PL, CreateObject("ZuluLib.ElemStyle"), -1, -1)
Y0 = L.Elements.Item(Key).PolyLine.GetY(1)
'Сдвигаем линию на D по оси Y с сохранением связей
L.Elements.Item(Key).Shift 0, D, True, 0
MsgBox "Линия " & Key & ": Y первой вершины " & Y0 & " -> " & L.Elements.Item(Key).PolyLine.GetY(1)
End Sub

Python:

import zulu

def Macro_Element_Shift():
    # Берем активный слой карты и его габариты
    L = zulu.App.ActiveMapDoc.Layers.Active
    R = L.GetBoundsRectangle()
    # Добавляем линию-примитив за краем данных слоя
    d = (R.Xmax - R.Xmin) / 10
    PL = zulu.PolyLine()
    PL.AddPoint(R.Xmax + d, R.Ymin)
    PL.AddPoint(R.Xmax + 2 * d, R.Ymin)
    key = L.AddPolyLine(PL, zulu.ElemStyle(), -1, -1)
    y0 = L.Elements.Item(key).PolyLine.GetY(1)
    # Сдвигаем линию на d по оси Y с сохранением связей
    L.Elements.Item(key).Shift(0, d, True, 0)
    print("Линия", key, ": Y первой вершины", y0, "->", L.Elements.Item(key).PolyLine.GetY(1))