ConvertToSymbol method (Element)

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

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

Element

Синтаксис:

Visual Basic:

Function ConvertToSymbol(Style As ElemStyle, ElemType As Long, ElemMode As Long, flags As Long) As Long

Style - стиль символьного примитива: символ из библиотеки слоя (SymbolID) и его размер (SymbolSize).

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

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

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

Описание:

Объект становится символьным с тем же ключом; прежняя геометрия не сохраняется. У линии символ ставится в точку на середине ее длины (ту же, что возвращает GetCenter), у площадного объекта - в точку со средними координатами его вершин. Изменение сразу вносится в слой.

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

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

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

Пример:

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

Visual Basic:

Sub Element_ConvertToSymbol
'Берем активный слой карты и его габариты
Set L = Zulu.ActiveMapDoc.Layers.Active
Set R = L.GetBoundsRectangle
If L.Symbols.Count = 0 Then
  MsgBox "В библиотеке слоя нет символов"
Else
  'Готовим ломаную за краем данных слоя
  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
  Key = L.AddPolyLine(PL, CreateObject("ZuluLib.ElemStyle"), -1, -1)
  'Стиль символьного примитива: первый символ библиотеки слоя
  Set St = CreateObject("ZuluLib.ElemStyle")
  St.SymbolID = L.Symbols.GetIdByIndex(0)
  St.SymbolSize = 100
  If L.Elements.Item(Key).ConvertToSymbol(St, -1, -1, 0) = 0 Then
    Set P = L.Elements.Item(Key).BasePoint
    MsgBox "Объект " & Key & " стал символом в точке " & P.X & "; " & P.Y
  Else
    MsgBox "Объект не преобразован"
  End If
End If
End Sub

Python:

import zulu

def Macro_Element_ConvertToSymbol():
    # Берем активный слой карты и его габариты
    L = zulu.App.ActiveMapDoc.Layers.Active
    R = L.GetBoundsRectangle()
    if L.Symbols.Count == 0:
        print("В библиотеке слоя нет символов")
        return
    # Готовим ломаную за краем данных слоя
    d = (R.Xmax - R.Xmin) / 10
    x = R.Xmax + d
    y = R.Ymin
    PL = zulu.PolyLine()
    PL.AddPoint(x, y)
    PL.AddPoint(x + d, y)
    key = L.AddPolyLine(PL, zulu.ElemStyle(), -1, -1)
    # Стиль символьного примитива: первый символ библиотеки слоя
    St = zulu.ElemStyle()
    St.SymbolID = L.Symbols.GetIdByIndex(0)
    St.SymbolSize = 100
    if L.Elements.Item(key).ConvertToSymbol(St, -1, -1, 0) == 0:
        P = L.Elements.Item(key).BasePoint
        print("Объект", key, "стал символом в точке", P.X, P.Y)
    else:
        print("Объект не преобразован")