SplitToLineSegments method (Element)

Разделяет линейный объект на отдельные объекты-отрезки по вершинам.

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

Element

Синтаксис:

Visual Basic:

Function SplitToLineSegments(flags As Long) As Long

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

Описание:

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

Метод возвращает 0, если линия разделена, и -1, если делить нечего (линия из одного отрезка) или объект не линейный.

Пример:

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

Visual Basic:

Sub Element_SplitToLineSegments
'Берем активный слой карты и его габариты
Set L = Zulu.ActiveMapDoc.Layers.Active
Set R = L.GetBoundsRectangle
'Добавляем ломаную-примитив из четырех вершин
D = (R.Xmax - R.Xmin) / 10
X = R.Xmax + D
Y = R.Ymin
Set PL = CreateObject("ZuluLib.PolyLine")
PL.AddPoint X, Y
PL.AddPoint X + D, Y
PL.AddPoint X + D, Y + D
PL.AddPoint X + 2 * D, Y + D
Key = L.AddPolyLine(PL, CreateObject("ZuluLib.ElemStyle"), -1, -1)
N = L.ElementKeys.Count
Res = L.Elements.Item(Key).SplitToLineSegments(0)
MsgBox "Результат " & Res & vbCrLf & "объектов в слое: " & N & " -> " & L.ElementKeys.Count & vbCrLf & _
  "вершин в исходной линии: " & L.Elements.Item(Key).PolyLine.NumTops
End Sub

Python:

import zulu

def Macro_Element_SplitToLineSegments():
    # Берем активный слой карты и его габариты
    L = zulu.App.ActiveMapDoc.Layers.Active
    R = L.GetBoundsRectangle()
    # Добавляем ломаную-примитив из четырех вершин
    d = (R.Xmax - R.Xmin) / 10
    x = R.Xmax + d
    y = R.Ymin
    PL = zulu.PolyLine()
    for px, py in ((x, y), (x + d, y), (x + d, y + d), (x + 2 * d, y + d)):
        PL.AddPoint(px, py)
    key = L.AddPolyLine(PL, zulu.ElemStyle(), -1, -1)
    n = L.ElementKeys.Count
    res = L.Elements.Item(key).SplitToLineSegments(0)
    print("Результат", res, ", объектов в слое:", n, "->", L.ElementKeys.Count,
          ", вершин в исходной линии:", L.Elements.Item(key).PolyLine.NumTops)