addparameter

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

Синтаксис:

addparameter(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 Текущее значение параметра

Описание:

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

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

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

Нет.