Справочное руководство по TDMS 7.0 API
Events Свойство
Смотри также  Отправить замечание
TDMSApplication Объект : Events Свойство

Glossary Item Box

Описание

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

Тип свойства

Read-only свойство

Опеделение

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

Пример

Смотри также

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