dbaddsignal
Функция добавления сигнала в заданную группу базы сигналов.
Синтаксис
fl = dbaddsignal(cat, group, name, desc, type, frm, mode, val);Аргументы
| Имя | Тип данных | Описание |
|---|---|---|
| cat | string |
Имя категории, в которую будет добавлен сигнал |
| group | string |
Имя группы сигналов категории cat, в которую будет добавлен сигнал |
| name | string |
Имя сигнала, который будет добавлен в группу group категории cat |
| desc | string |
Название добавляемого в БД сигнала |
| type | integer |
Тип данных для добавляемого сигнала (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 | string |
Интерпретируемое значение сигнала (формула), в общем случае аргумент строкового типа |
| mode | integer |
Способ расчета (0 – переменная, 1 – константа, 3 - заблокирована); |
| val | Произвольный тип данных | Задание текущего значения, аргумент произвольного типа, будет приведен к типу type сигнала |
Описание
dbaddsignal – функция создания сигнала, с указанными атрибутами внутри
определенной группы базы сигналов. При этом заданная группа сигналов должна существовать! В
случае, если отсутствует указанная категория, либо группа сигналов – сигнал не будет
добавлен.
Результат
| Имя | Тип данных | Описание |
|---|---|---|
| fl | boolean |
Функция возвращает число типа boolean: 1 – сигнал успешно добавлен, 0 – сигнал не был добавлен (либо уже есть, либо не найден заданный путь) |
Пример
var nm, nm2, nm3: string;
nm = "категория_1";
nm2 = "группа1";
nm3 = "signal2";
fl = dbaddsignal(nm, nm2, nm3, "сигнал2", 1, "", 1, 14);В результате выполнения данного скрипта, в подключенной к проекту базе сигналов будет создана новый сигнал с именем "signal2" внутри категории с именем "категория_1" и группы с именем "группа1", обладающий заданными атрибутами. Интерпретируемое значение сигнала пустое, текущее значение сигнала равно 14. В случае задания одновременно и текущего и интерпретируемого значения, интерпретируемое перепишет текущее на первом шаге расчета.
Дополнительные материалы
Нет.