Способы задания параметров функций |
API Конфигуратора позволяет передавать объекты как по имени, так и по указателю на объект. Таким образом, параметр aObjName или aContainer может быть как строкой string при передаче объекта по имени, так и числом longInt - при передаче объекта по указателю.
В связи с тем, что имя объекта может быть не уникальным, при передаче объекта по имени поиск объекта производится в текущем корневом контейнере (контейнере верхнего уровня), заданном функцией cfsSetCurrentContainer.
Корневые объекты могут быть найдены по имени при любом текущем корневом контейнере при условии, что в нем нет подобъекта с таким именем.
Для передачи типа объекта (параметр typeName) можно использовать имя типа или код типа (строка string или число longInt).
Данное соглашение остается в силе при передаче свойств объектов (параметр propName), при этом передается имя свойства или код свойства.
Например, можно написать:
cfsSetProp ('MyInterface', 'Title', 'Бухгалтерская ведомость');
или
var myInterfaceSelf : longInt; // self получается с помощью cfsGetObjInfo // или cfsEnumObjects, cfsGetSelectedObjects cfsSetProp (myInterfaceSelf, cfpTitle, 'Бухгалтерская ведомость');
Аналогично возвращаться могут коды или указатели, если используется переменная longInt, либо строки, если переменная имеет тип string.
При несовпадении таких типов параметров с типом longInt или string выдается сообщение cfErrBadFieldType.