ConvertToPolygon method (Element)

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

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

Element

Синтаксис:

Visual Basic:

Function ConvertToPolygon(Style As ElemStyle, ElemType As Long, ElemMode As Long, Delta As Double) As Long

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

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

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

Delta - наибольшее расстояние между концами линии в метрах, при котором они соединяются.

Описание:

Линия становится площадным объектом с тем же ключом. Если концы линии не совпадают, но расстояние между ними не больше Delta метров, они сводятся в одну вершину посередине между ними. Если концы дальше Delta или после соединения концов не остается трех вершин, объект остается линией. Изменение сразу вносится в слой.

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

Метод возвращает 0 и в тех случаях, когда объект не преобразован (концы дальше Delta, объект не линейный). Результат проверяют по графическому типу GraphType. Обратное преобразование выполняет метод ConvertToPolyline.

Пример:

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

Visual Basic:

Sub Element_ConvertToPolygon
'Берем активный слой карты и его габариты
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, Y
Key = L.AddPolyLine(PL, CreateObject("ZuluLib.ElemStyle"), -1, -1)
'Стиль площадного примитива: красная заливка стилем 2 из библиотеки слоя
Set St = CreateObject("ZuluLib.ElemStyle")
St.FillStyle = 2
St.PatColor = RGB(255, 0, 0)
'Концы ломаной совпадают, поэтому Delta = 0
L.Elements.Item(Key).ConvertToPolygon St, -1, -1, 0
Set E = L.Elements.Item(Key)
MsgBox "Объект " & Key & ": графический тип " & E.GraphType & ", площадь " & E.Area & " га"
End Sub

Python:

import zulu

def Macro_Element_ConvertToPolygon():
    # Берем активный слой карты и его габариты
    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, y)):
        PL.AddPoint(px, py)
    key = L.AddPolyLine(PL, zulu.ElemStyle(), -1, -1)
    # Стиль площадного примитива: красная заливка стилем 2 из библиотеки слоя
    St = zulu.ElemStyle()
    St.FillStyle = 2
    St.PatColor = 255
    # Концы ломаной совпадают, поэтому Delta = 0
    L.Elements.Item(key).ConvertToPolygon(St, -1, -1, 0)
    E = L.Elements.Item(key)
    print("Объект", key, ": графический тип", E.GraphType, ", площадь", E.Area, "га")