События WillMove и MoveComplete (ADO)

Событие WillMove вызывается до того, как ожидающая операция изменяет текущую позицию в наборе записей. Событие MoveComplete вызывается после текущей позиции в наборе записей .

Синтаксис

  
WillMove adReason, adStatus, pRecordset  
MoveComplete adReason, pError, adStatus, pRecordset  

Параметры

adReason
Значение EventReasonEnum, указывающее причину этого события. Его значение может быть adRsnMoveFirst, adRsnMoveLast, adRsnMoveNext, adRsnMovePrevious, adRsnMove ИлиadRsnRequery.

pError
Объект error. В нем описывается ошибка, которая произошла, если значение adStatus является adStatusErrorsOccurred; в противном случае параметр не задан.

adStatus
Значение состояния EventStatusEnum.

При вызове WillMove этот параметр имеет значение adStatusOK , если операция, вызвавшей событие, была успешной. Оно имеет значение adStatusCantDeny, если это событие не может запросить отмену ожидающей операции.

При вызове MoveComplete этот параметр имеет значение adStatusOK , если операция, вызвавшей событие успешно, или adStatusErrorsOccurred , если операция завершилась ошибкой.

Перед возвратом WillMove задайте для этого параметра adStatusCancel запрос на отмену ожидающей операции или задайте для этого параметра значение adStatusUnwantedEvent , чтобы предотвратить последующие уведомления.

Перед возвратом MoveComplete задайте для этого параметра значение adStatusUnwantedEvent , чтобы предотвратить последующие уведомления.

pRecordset
Объект набора записей. Набор записей , для которого произошло это событие.

Замечания

Событие WillMove или MoveComplete может возникать из-за следующих операций набора записей: Open, MoveFirst, MoveFirst, MoveNext, MovePrevious, AddNew и Requery. Эти события могут возникать из-за следующих свойств: Filter, Index, Bookmark, AbsolutePage и AbsolutePosition. Эти события также происходят, если дочерний набор записей подключен к событиям Набора записей , а родительский набор записей перемещается.

Для каждого возможного значения adReason необходимо задать параметр adStatusUnwantedEvent, чтобы полностью остановить уведомление о событиях для любого события, включающего параметр adReason.

См. также

Пример модели событий ADO (VC++)
Сводка обработчика событий ADO
объекта набора записей