ConvertToPolyline method (Element)

Преобразует площадной объект в линейный: контуры становятся замкнутыми линиями.

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

Element

Синтаксис:

Visual Basic:

Function ConvertToPolyline(Style As ElemStyle, ElemType As Long, ElemMode As Long) As Long

Style - стиль линейного примитива; Nothing - стиль по умолчанию. В Python значение None не принимается (TypeError): передают объект ElemStyle.

ElemType - ID линейного типа; -1 - примитив.

ElemMode - номер режима линейного типа; -1 - примитив.

Описание:

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

Если ElemType и ElemMode задают линейный тип слоя и его режим, получается типовая линия. При значениях -1, а также если тип не линейный, получается линейный примитив со стилем Style.

Метод возвращает 0; у линейного объекта он ничего не меняет и тоже возвращает 0. Результат проверяют по графическому типу GraphType. Обратное преобразование выполняет метод ConvertToPolygon.

Пример:

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

Visual Basic:

Sub Element_ConvertToPolyline
'Берем активный слой карты и его габариты
Set L = Zulu.ActiveMapDoc.Layers.Active
Set R = L.GetBoundsRectangle
'Готовим квадратный контур за краем данных слоя
D = (R.Xmax - R.Xmin) / 10
X = R.Xmax + D
Y = R.Ymin
Set C = CreateObject("ZuluLib.Contour")
C.AddPoint X, Y
C.AddPoint X + D, Y
C.AddPoint X + D, Y + D
C.AddPoint X, Y + D
Key = L.AddContour(C, CreateObject("ZuluLib.ElemStyle"), -1, -1)
'Стиль линейного примитива: синяя линия толщиной 2
Set St = CreateObject("ZuluLib.ElemStyle")
St.LineColor = RGB(0, 0, 255)
St.LineWidth = 2
L.Elements.Item(Key).ConvertToPolyline St, -1, -1
Set E = L.Elements.Item(Key)
MsgBox "Объект " & Key & ": графический тип " & E.GraphType & ", длина " & E.Length & " см"
End Sub

Python:

import zulu

def Macro_Element_ConvertToPolyline():
    # Берем активный слой карты и его габариты
    L = zulu.App.ActiveMapDoc.Layers.Active
    R = L.GetBoundsRectangle()
    # Готовим квадратный контур за краем данных слоя
    d = (R.Xmax - R.Xmin) / 10
    x = R.Xmax + d
    y = R.Ymin
    C = zulu.Contour()
    for px, py in ((x, y), (x + d, y), (x + d, y + d), (x, y + d)):
        C.AddPoint(px, py)
    key = L.AddContour(C, zulu.ElemStyle(), -1, -1)
    # Стиль линейного примитива: синяя линия толщиной 2
    St = zulu.ElemStyle()
    St.LineColor = 16711680
    St.LineWidth = 2
    L.Elements.Item(key).ConvertToPolyline(St, -1, -1)
    E = L.Elements.Item(key)
    print("Объект", key, ": графический тип", E.GraphType, ", длина", E.Length, "см")