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 Имя файла базы данных    
Более подробная информация о типах данных представлена в статье Типы данных.

Результат:

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

Пример:

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

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