Справочное руководство по TDMS 5.0 API
Events Property
Смотри также  Послать замечания
TDMSApplication Объект : Events Property

Glossary Item Box

Описание

Коллекция всех событий, зарегистрированных в приложении с момента установки.

Тип свойства

Только для чтения

Определение

Visual Basic
Public Property Events As TDMSEvents

Тип возврата

Ссылка на коллекцию зарегистрированных событий.

Заметки

1. В коллекцию  TDMSEvents объекта Application автоматически добавляются все события, произошедшие в приложении с момента его установки на компьютер. Коллекция включает в себя события, связанные с действиями пользователей (например, вход в систему), события объектов TDMSObject.Events и программно созданные объекты TDMSEvent. Все зарегистрированные в приложении события могут быть просмотрены через интерфейс (Системные -> Показать Журнал событий...). Множество регистрируемых событий может быть ограничено настройками Журнала событий  (Системные > Параметры > Журнал событий) как по классам событий, так и по отдельным пользователям.

Предупреждение: в многопользовательской среде "накопление" событий происходит очень быстро, коллекция может включать в себя сотни тысяч объектов. Поэтому время ее запроса и обработки может быть существенным (десятки секунд). Чтобы этого не происходило, можно проводить "чистку" Журнала или ограничить регистрацию событий с помощью настроек Журнала. 

При работе с коллекцией событий через API желательно использовать фильтр событий TDMSEventsFilter. Это позволяет максимально ускорить время выполнения скрипта: фактически при обращении к свойству TDMSApplication.Events возвращается пустая коллекция. Её инициализация происходит только при первом обращении к свойствам Item, Has или Count. Такой механизм позволяет сначала настроить фильтр событий без задержек, связанных с обработкой большого количества объектов TDMSEvent.

2. Свойство доступно начиная с версии 2.0.

3. Создавать и удалять элементы в коллекции может только системный администратор. 

Пример

Смотри также

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