addparameter

Функция добавления параметра в блок

Синтаксис:

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

Аргументы:

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

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

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

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

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

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

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

Описание:

addparameter – функция создает параметр с заданными атрибутами в блоке с идентификатором 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	Имя файла базы данных

Более подробная информация о типах данных представлена в статье tipy_dannyh.dita#.

Результат:

Происходит добавление нового параметра в список параметров заданного блока.

Пример:

testblock = getobj(1);  // id блока
idx = getparameterindex(testblock, "param1");  // индекс существующего параметра
if idx >= 0 then deleteparameter(testblock, idx);  // удаление существующего параметра    
addparameter(testblock, -1,  0, "param1", "parameter", "", 3);  // добавление нового параметра в конец списка

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