Описание
Генерируется в случае успешного добавления файла к объекту. Если добавляется группа файлов - событие генерируется для каждого файла в отдельности.
Опеделение
| Visual Basic |
|---|
Public Event FileAdded( _ ByVal pFile As TDMSFile, _ ByVal pObject As TDMSObject _ ) |
Параметры
- pFile
- Ссылка на файл, который должен быть добавлен к объекту.
- pObject
- Ссылка на объект, к которому должен быть добавлен файл.
Заметки
1. Событие нельзя отменить.
2. Обработчик может быть размещен в скриптах объекта, профиля и/или общесистемном. Если обработчики определены на всех уровнях, то последовательность их вызова такова:
- скрипт объекта;
- скрипт профиля пользователя;
- общесистемный скрипт.
Если на каком-либо уровне событие было отменено (параметру bCancel присвоено значение TRUE), то обработчики события, размещенные на последующих уровнях, вызваны не будут.
3. Схему последовательности генерации событий при добавлении файлов в файловый состав объекта см. на рисунке:
4. Для того, чтобы событие генерировалось при работе с файлами через API, должен быть включен вызов объектных событий в Окне свойств базы данных (см. рисунок).
Пример
| VB Script (Visual Basic) |  Скопировать код |
|---|---|
'==================================================== 'Текст обработчика может быть размещен в скрипте формы, профиля или 'общесистемном скрипте. Sub File_Added(File, Object) 'Вывести информацию о результате операции MsgBox "Файл """ & File.FileName & """ успешно добавлен к объекту" & Chr(13) &_ """" & Object.Description & """.", vbInformation, "Добавление файла к объекту" End Sub '==================================================== | |