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. Создавать и удалять элементы в коллекции может только системный администратор.