SetBLOB method (FillStyleDef)

Копирует стиль заливки из массива двоичных данных (от BLOB - binary large object).

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

FillStyleDef

Синтаксис:

Visual Basic:

Function SetBLOB(vBlob) As Boolean

vBlob - VARIANT с массивом байт.

Описание:

Блок, полученный методом GetBLOB, заменяет набор элементов узора описателя целиком, и метод возвращает True. Номер стиля из блока не восстанавливается: Id остается -1, пока стиль не добавлен в библиотеку слоя методом AddItem.

Значение, которое не является массивом (строка, число, пустое значение, объект), отвергается: метод возвращает False, описатель остается прежним. Массив байт метод принимает и тогда, когда в нем нет данных стиля заливки (посторонние байты): возвращает True, а описатель остается без элементов. Блок стиля линии (LineStyleDef.GetBLOB) метод отвергает (False), но элементы описателя при этом тоже удаляются. Поэтому результат надежнее проверять числом элементов (StyleElements).

В макросах на Python метод бесполезен: единственный источник блока - GetBLOB, а он там возвращает None, и метод отвечает False.

Пример:

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

Visual Basic:

Sub FillStyleDef_SetBLOB
'Берем активный слой карты и его библиотеку стилей заливок
Set L = Zulu.ActiveMapDoc.Layers.Active
Set FS = L.FillStyles
Set src = FS.Item(0)
'Переносим стиль в новый описатель
Set dst = CreateObject("ZuluLib.FillStyleDef")
S = "SetBLOB: " & dst.SetBLOB(src.GetBLOB)
S = S & vbCrLf & "элементов в копии: " & dst.StyleElements.Count
'Не массив метод не принимает, копия остается прежней
S = S & vbCrLf & "SetBLOB со строкой: " & dst.SetBLOB("не стиль") & ", элементов " & dst.StyleElements.Count
'Кладем копию в библиотеку стилей слоя отдельным стилем
S = S & vbCrLf & "копия добавлена под номером " & FS.AddItem(dst, -1)
MsgBox S
End Sub