SetRaster method (Element)

Задает новые параметры растрового объекта.

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

Element

Синтаксис:

Visual Basic:

Function SetRaster(NewRaster As ZRasterParams) As Boolean

NewRaster - новые параметры растра.

Описание:

Метод работает у объекта растрового слоя (описателя растра ZRS). Параметры обычно получают методом GetRaster - он возвращает копию, и ее изменение растр не меняет, - меняют и передают в SetRaster. Новые параметры сразу применяются к объекту и записываются в описатель ZRS.

Метод возвращает False и тогда, когда параметры применены; результат проверяют повторным вызовом GetRaster. У объектов векторного слоя метод возвращает False и ничего не меняет.

Пример:

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

Visual Basic:

Sub Element_SetRaster
'Берем активный слой карты и его первый объект
Set L = Zulu.ActiveMapDoc.Layers.Active
Set E = L.Elements.Item(L.ElementKeys.Item(1))
Set Ras = E.GetRaster
If Ras Is Nothing Then
  MsgBox "Активный слой не растровый"
Else
  'Меняем копию параметров и передаем ее объекту
  Ras.Transparency = 50
  E.SetRaster Ras
  MsgBox "Прозрачность растра: " & L.Elements.Item(E.Key).GetRaster.Transparency
End If
End Sub

Python:

import zulu

def Macro_Element_SetRaster():
    # Берем активный слой карты и его первый объект
    L = zulu.App.ActiveMapDoc.Layers.Active
    E = L.Elements.Item(L.ElementKeys.Item(1))
    Ras = E.GetRaster()
    if Ras is None:
        print("Активный слой не растровый")
    else:
        # Меняем копию параметров и передаем ее объекту
        Ras.Transparency = 50
        E.SetRaster(Ras)
        print("Прозрачность растра:", L.Elements.Item(E.Key).GetRaster().Transparency)