Описание
Генерируется перед добавлением объектов в состав родительского объекта.
Определение
| Visual Basic |
|---|
Public Event ObjectBeforeContentAdd( _ ByVal pObject As TDMSObject, _ ByVal pContent As TDMSObjects, _ ByRef bCancel As Boolean _ ) |
Параметры
- pObject
- Объект, в состав которого будут добавлены дочерние объекты.
- pContent
- Коллекция добавляемых объектов.
- bCancel
- TRUE - отменить изменение состава объекта.
Заметки
1. Событие является отменяемым: если параметру bCancel присвоено значение TRUE, добавление объектов в состав не произойдет.
2. Обработчик может быть размещен в скриптах объекта, профиля и/или общесистемном (см. рисунок). Если обработчики определены на всех уровнях, то последовательность их вызова такова:
- скрипт объекта;
- скрипт профиля пользователя;
- общесистемный скрипт.
Если на каком-либо уровне событие было отменено (параметру bCancel присвоено значение TRUE), то обработчики события, размещенные на последующих уровнях, вызваны не будут.
3. Для того, чтобы событие генерировалось при работе через API, должен быть включен вызов объектных событий в Окне свойств базы данных (см. рисунок).
