WillMove 和 MoveComplete 事件 (ADO)
在挂起的操作更改 Recordset中的当前位置之前,调用 WillMove 事件。 MoveComplete 事件在 Recordset 中的当前位置 更改后调用。
语法
WillMove adReason, adStatus, pRecordset
MoveComplete adReason, pError, adStatus, pRecordset
参数
adReason
EventReasonEnum 值,该值指定此事件的原因。 其值 可以是 adRsnMoveFirst、adRsnMoveLast、adRsnMoveNext、adRsnMovePrevious、adRsnMove或 adRsnRequery。
pError
错误 对象。 它描述 adStatus 的值 adStatusErrorsOccurred时发生的错误;否则,未设置参数。
adStatus
EventStatusEnum 状态值。
调用 WillMove 时,如果导致事件的操作成功,此参数将设置为 adStatusOK。 如果此事件无法请求取消挂起的操作,则会将其设置为 adStatusCantDeny。
调用 moveComplete 时,如果导致事件的操作成功,或 adStatusErrorsOccurred 如果操作失败,此参数将设置为 adStatusErrorsOccurred。
在 WillMove 返回之前,请将此参数设置为 adStatusCancel 请求取消挂起的操作,或将此参数设置为 adStatusUnwantedEvent 以防止后续通知。
在 MoveComplete 返回之前,请将此参数设置为 adStatusUnwantedEvent 以防止后续通知。
pRecordset
Recordset 对象。 发生此事件的 Recordset。
言论
由于以下 记录集 操作,WillMove 或 MoveComplete 事件发生:Open、Move、MoveFirst、MoveLast、MoveNext、MovePrevious、AddNew和 Requery。 这些事件可能由于以下属性而发生:Filter、Index、Bookmark、AbsolutePage和 AbsolutePosition。 如果子 Recordset 已连接记录集 事件 且移动父 Recordset,则也会发生这些事件。
必须为每个可能的 adReason 值将 adStatus 参数设置为 adStatusUnwantedEvent,才能针对包含 adReason 参数的任何事件完全停止事件通知。