dbaddsignal

Функция добавления сигнала в заданную группу базы сигналов.

Синтаксис:

dbaddsignal(cat, group, name, desc, type, frm, mode, val);

Аргументы:

cat – имя категории, в которую будет добавлен сигнал;

group – имя группы сигналов категории cat, в которую будет добавлен сигнал;

name – имя сигнала, который будет добавлен в группу group категории cat;

desc – название добавляемого в БД сигнала;

type – тип данных для добавляемого сигнала (0 – вещественное, 1 – целое, 2 – двоичное, 3 – цвет, 4 – строка, 5 – массив, 6 – растровое изображение, 7 – шрифт, 8 – текст, 9 – стиль линии, 10 – стиль заливки, 11 – формат числа, 12 – целый массив, 13 – матрица, 14 – точка, 15 – пречисление, 16 – имя файла, 17 – имя файла базы данных, 18 – произвольные данные, 19 – составной тип данных, 20 – множество, 21 – комплексное, 22 – комплексный вектор, 23 – комплексная матрица, 24 – внешний тип данных, 25 – команда управления);

frm – интерпретируемое значение сигнала (формула), в общем случае аргумент строкового типа;

mode – способ расчета (0 – переменная, 1 – константа, 3 - заблокирована);

val - задание текущего значения, аргумент произвольного типа, будет приведен к типу type сигнала.

Описание:

dbaddsignal – функция создания сигнала, с указанными атрибутами внутри определенной группы базы сигналов. При этом заданная группа сигналов должна существовать! В случае, если отсутствует указанная категория, либо группа сигналов – сигнал не будет добавлен.

Результат:

Функция возвращает число типа boolean: 1 – сигнал успешно добавлен, 0 – сигнал не был добавлен (либо уже есть, либо не найден заданный путь).

Пример:

var nm, nm2, nm3:string;
nm = "категория_1";
nm2 = "группа1";
nm3 = "signal2";
aaa = dbaddsignal(nm, nm2, nm3, "сигнал2", 1, "", 1, 14);

В результате выполнения данного скрипта, в подключенной к проекту базе сигналов будет создана новый сигнал с именем «signal2» внутри категории с именем «категория_1» и группы с именем «группа1», обладающий заданными атрибутами. Интерпретируемое значение сигнала пустое, текущее значение сигнала равно 14. В случае задания одновременно и текущего и интерпретируемого значения, интерпретируемое перепишет текущее на первом шаге расчета.

Сопутствующие материалы