ShadePolygon method (Element)

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

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

Element

Синтаксис:

Visual Basic:

Function ShadePolygon(X1 As Double, Y1 As Double, X2 As Double, Y2 As Double, Step As Double, flags As Long, Style As ElemStyle) As Long

X1, Y1, X2, Y2 - отрезок, задающий направление штриховки, в координатах слоя.

Step - расстояние между линиями штриховки в метрах.

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

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

Описание:

Метод добавляет в слой новый объект - линию-примитив, сегменты которой параллельны отрезку (X1, Y1) - (X2, Y2), идут через Step метров и обрезаны границей объекта. Сам площадной объект не меняется.

Метод возвращает ключ добавленной штриховки; -1 - если объект не площадной или отрезок направления нулевой длины.

Пример:

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

Visual Basic:

Sub Element_ShadePolygon
'Берем активный слой карты и его габариты
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)
'Красные линии штриховки вдоль оси X через 5 м
Set St = CreateObject("ZuluLib.ElemStyle")
St.LineColor = RGB(255, 0, 0)
HKey = L.Elements.Item(Key).ShadePolygon(X, Y, X + D, Y, 5, 0, St)
If HKey = -1 Then
  MsgBox "Штриховка не добавлена"
Else
  MsgBox "Штриховка " & HKey & ": линий " & L.Elements.Item(HKey).PolyPolyLine.Count
End If
End Sub

Python:

import zulu

def Macro_Element_ShadePolygon():
    # Берем активный слой карты и его габариты
    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)
    # Красные линии штриховки вдоль оси X через 5 м
    St = zulu.ElemStyle()
    St.LineColor = 255
    hkey = L.Elements.Item(key).ShadePolygon(x, y, x + d, y, 5, 0, St)
    if hkey == -1:
        print("Штриховка не добавлена")
    else:
        print("Штриховка", hkey, ": линий", L.Elements.Item(hkey).PolyPolyLine.Count)