WillMove 和 MoveComplete 事件 (ADO)

适用于：Access 2013、Office 2013

在挂起操作更改 Recordset 中的当前位置之前调用 WillMove 事件。 在 Recordset 中的当前位置更改之后调用 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 对象。 发生此事件的 Recordset。

备注

由于以下 Recordset 操作，可能会发生 WillMove 或 MoveComplete 事件：

• “打开”
• 移动
• MoveFirst
• MoveLast
• MoveNext
• MovePrevious
• AddNew
• Requery

这些事件可能是由于以下属性而发生的：

• 筛选
• "索引"
• Bookmark
• AbsolutePage
• AbsolutePosition

如果子 Recordset 与 Recordset 事件相连且父 Recordset 被移动，那么也有可能发生这两个事件。

对于每个可能的 adReason 值，必须将 adStatus 参数设置为 adStatusUnwantedEvent，才能完全阻止包括 adReason 参数的任何事件的事件通知。