addproperty

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

Синтаксис:

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

Аргументы:

block_id - идентификатор блока;

ind - целое значение, номер свойства в списке;

dt_type - целое значение, тип данных свойства;

name - строка, имя свойства;

caption - строка, название свойства;

formula - строка, интерпретируемое значение (формула);

value - текущее значение свойства.

Описание:

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);  // добавление нового свойства в конец списка

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