addproperty

Функция добавления свойства в блок

Синтаксис

addproperty(block_id, ind, dt_type, name, caption, formula, value);

Аргументы

Имя Тип данных Описание
block_id integer Идентификатор блока
ind integer Номер свойства в списке
dt_type integer Тип данных свойства
name string Имя свойства
caption string Название свойства
formula string Интерпретируемое значение (формула)
value double Текущее значение свойства

Описание

addproperty – функция создает свойство с заданными атрибутами в блоке с идентификатором block_id. Идентификатор блока может быть получен, например, функциями getobj, createblock, findobjectbyfullname и другими.
Прим.:
если ind = -1, то свойство вставляется в конец списка.
Прим.:
соответствие между значениями аргумента dt_type и типами данных, приведено в таблице:
Значение Тип данных Значение Тип данных Значение Тип данных
0 Вещественное 9 Стиль линии 18 Произвольные данные
1 Целое 10 Стиль заливки 19 Составной тип
2 Двоичное 11 Формат числа 20 Множество
3 Цвет 12 Целый массив 21 Комплексное
4 Строка 13 Матрица 22 Комплексный вектор
5 Массив 14 Точка 23 Комплексная матрица
6 Растровое изображение 15 Перечисление 24 Внешний тип данных
7 Шрифт 16 Имя файла 25 Команда управления
8 Текст 17 Имя файла базы данных

Результат

Имя Тип данных Описание
Происходит добавление нового свойства в список свойств заданного блока.

Пример

testblock = getobj(1);  // id блока
idx = getpropertyindex(testblock, "prop1");  // индекс существующего свойства
if idx >= 0 then deleteproperty(testblock, idx);  // удаление существующего свойства    
addproperty(testblock, -1,  0, "prop1", "property", "", 3);  // добавление нового свойства в конец списка

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

Дополнительные материалы

Нет.