- pSheet
- Таблица выборки. Может быть произвольно отформатирована, поскольку будет выведена на экран только после вызова обработчика данного события.
- pQuery
- Запрос, который был выполнен.
- pObject
- Объект, в состав которого входит выборка. Nothing, если выборка выполняется в окне свойств или методом TDMSApplication.ExecuteQuery Метод.
Использование обработки события может быть полезным, когда необходимо отформатировать таблицу (передается в параметре pSheet), содержащую итоговый набор объектов.
1. Событие нельзя отменить.
2. Обработчик может быть размещен в скриптах выборки, профиля и/или общесистемном. Если обработчики определены на всех уровнях, то последовательность их вызова такова:
- скрипт выборки;
- скрипт профиля пользователя;
- общесистемный скрипт.
3. Схему последовательности генерации событий при установке фокуса на выборке см. на рисунке:
Предупреждение: при обращении к свойству TDMSQuery.Objects Свойство параметра pQuery TDMSQuery Объект выполняется запрос, и, как следствие, наступают события QueryBeforeExecute и QueryAfterExecute. Таким образом, обработчики событий начинают вызываться в бесконечном цикле и приложение "зависает". Подобных ситуаций необходимо избегать.
4. Событие генерируется при выполнении запроса любыми средствами пользовательского интерфейса (в том числе и в окне свойств выборки). Для того, чтобы событие генерировалось при работе через API (напр., при вызове TDMSApplication.ExecuteQuery Метод), должен быть включен вызов объектных событий в Окне свойств базы данных (см. рисунок).