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

Область применения: Access 2013, Office 2013

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

Синтаксис

WillMoveadReason, adStatus, pRecordset

MoveCompleteadReason, 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 может произойти из-за следующих операций с набором записей :

• Открыть
• Перемещение
• MoveFirst
• MoveLast
• MoveNext
• MovePrevious
• AddNew
• Requery

Эти события могут возникать из-за следующих свойств:

• Фильтр
• Индекс;
• Bookmark
• AbsolutePage
• AbsolutePosition

Эти события также возникают, если дочерний набор записей имеет подключенные события Recordset и родительский набор записей перемещен.

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