Справочное руководство по TDMS 5.0 API
FileBeforeAdd Event
Смотри также  Послать замечания
pFile
Ссылка на файл, который должен быть добавлен к объекту.
pObject
Ссылка на объект, к которому должен быть добавлен файл.
bCancel
TRUE - отменить добавление файла к объекту.
sFilePath

Исходный полный путь к файлу. Параметр только для чтения.

TDMSApplication Объект : FileBeforeAdd Event

Glossary Item Box

Описание

Генерируется перед добавлением файла к объекту. Если добавляется группа файлов - событие генерируется для каждого файла в отдельности.

Определение

Visual Basic
Public Event FileBeforeAdd( _
   ByVal pFile As TDMSFile, _
   ByVal pObject As TDMSObject, _
   ByRef bCancel As Boolean, _
   ByVal sFilePath As String _
)

Параметры

pFile
Ссылка на файл, который должен быть добавлен к объекту.
pObject
Ссылка на объект, к которому должен быть добавлен файл.
bCancel
TRUE - отменить добавление файла к объекту.
sFilePath

Исходный полный путь к файлу. Параметр только для чтения.

Заметки

1. Событие является отменяемым: если параметру bCancel присвоено значение TRUE, добавление текущего файла будет отменено.

2. В случае "ручного" добавления файлов событие генерируется после выбора файла в окне диалога, но перед внесением любых связанных изменений в базу.

3. Обработчик может быть размещен в скриптах объекта, профиля и/или общесистемном (см. рисунок). Если обработчики определены на всех уровнях, то последовательность их вызова такова:

  • скрипт объекта;
  • скрипт профиля пользователя;
  • общесистемный скрипт.

Если на каком-либо уровне событие было отменено (параметру bCancel присвоено значение TRUE), то обработчики события, размещенные на последующих уровнях, вызваны не будут.

4. Схему последовательности генерации событий при добавлении файлов в файловый состав объекта см. на рисунке.

5. Для того, чтобы событие генерировалось при работе с файлами через API, должен быть включен вызов объектных событий в Окне свойств базы данных (см. рисунок).

Включение генерации объектных событий

Пример

Смотри также

© 2016 CSoft Development. Все права защищены.