WillMove 和 MoveComplete 事件 (ADO)
在暫止的作業變更 Recordset 中的目前位置之前,系統會呼叫 WillMove 事件。 在 Recordset 中的目前位置變更之後,系統會呼叫 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 物件。 發生此事件的 Recordset。
備註
WillMove 或 MoveComplete 事件可能會因為下列 Recordset 作業而發生:Open、Move、MoveFirst、MoveLast、MoveNext、MovePrevious、AddNew 和 Requery。 這些事件可能是因為下列屬性而發生:Filter、Index、Bookmark、AbsolutePage 和 AbsolutePosition。 如果子 Recordset 已連接 Recordset 事件,且父 Recordset 有移動,也會發生這些事件。
您必須針對每個可能的 adReason 值將 adStatus 參數設定為 adStatusUnwantedEvent,才能針對包含 adReason 參數的任何事件完全停止事件通知。