SetBitmap method (FillStyleElement)

Задает растровое изображение, которым рисуется элемент узора заливки.

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

FillStyleElement

Синтаксис:

Visual Basic:

Function SetBitmap(Stream As IUnknown, TransparentColor As Long) As Boolean

Stream - двоичный поток с изображением.

TransparentColor - цвет, отмечаемый в изображении особо (см. ниже).

Описание:

Элемент узора становится растровым: в заливке повторяется изображение из потока, с шагом SetStepHor и SetStepVer; без шага изображения стоят вплотную. Поток - двоичный (например, ADODB.Stream с Type = 1); изображение читается с начала потока, принимаются форматы BMP, PNG, JPEG и GIF. Метод возвращает True, если изображение принято, и False для пустого потока и посторонних данных.

Цвет TransparentColor задается в порядке байт 0xRRGGBB - обратном функции RGB: например, желтому цвету соответствует &HFFFF00, а не RGB(255, 255, 0). Точки этого цвета в образце (DrawSampleImage) и при выводе методом Draw рисуются черными. Если отмечать цвет не нужно, передают цвет, которого в изображении нет.

В модуле zulu для Python метода нет: члены с параметром-потоком в Python не выведены.

Пример:

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

Visual Basic:

Sub FillStyleElement_SetBitmap
'Берем активный слой карты
Set L = Zulu.ActiveMapDoc.Layers.Active
'Читаем изображение узора в двоичный поток
Set st = CreateObject("ADODB.Stream")
st.Type = 1
st.Open
st.LoadFromFile "C:\Data\pattern.bmp"
'Цвет &H123456 в изображении не встречается
Set fse = CreateObject("ZuluLib.FillStyleElement")
If Not fse.SetBitmap(st, &H123456) Then
  MsgBox "Изображение не принято"
  Exit Sub
End If
'Шаг повторения изображения
fse.SetStepHor 24.0
fse.SetStepVer 24.0
Set fsd = CreateObject("ZuluLib.FillStyleDef")
fsd.AddElement fse
MsgBox "Новый стиль заливки получил Id " & L.FillStyles.AddItem(fsd, -1)
End Sub