События 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
Объект Recordset . Набор записей, для которого произошло это событие.

Комментарии

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

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

См. также:

Пример модели событий ADO (Visual C ++)
Общие сведения об обработчике событий ADO
Объект Recordset (ADO)