pSheet

Таблица выборки. Может быть произвольно отформатирована, поскольку будет выведена на экран только после вызова обработчика данного события.

pQuery

Запрос, который был выполнен.

pObject

Объект, в состав которого входит выборка. Nothing, если выборка выполняется в окне свойств или методом TDMSApplication.ExecuteQuery.

Использование обработки события может быть полезным, когда необходимо отформатировать таблицу (передается в параметре pSheet), содержащую итоговый набор объектов.

1. Событие нельзя отменить.

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

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

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

Предупреждение: при обращении к свойству Objects параметра pQuery выполняется запрос, и, как следствие, наступают события QueryBeforeExecute и QueryAfterExecute. Таким образом, обработчики событий начинают вызываться в бесконечном цикле и приложение "зависает". Подобных ситуаций необходимо избегать (см. пример).

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

TDMSApplication Объект  | TDMSApplication Члены  | TDMSQuery  | QueryBeforeExecute