WillMove and MoveComplete (RecordsetEvent) 方法

WillMove and MoveComplete (RecordsetEvent) 方法

   

WillMove 方法在掛起操作更改 Recordset 中的當(dāng)前位置前調(diào)用。MoveComplete 方法則在 Recordset 的當(dāng)前位置更改后調(diào)用。

語(yǔ)法

WillMove adReason, adStatus, pRecordset

MoveComplete adReason, pError, adStatus, pRecordset

參數(shù)

adReason   EventReasonEnum 值，指定該事件的原因。它的值可以是 adRsnMoveFirst、adRsnMoveLast、adRsnMoveNext、adRsnMovePrevious、adRsnMove 或 adRsnRequery。

pError   Error 對(duì)象，說(shuō)明當(dāng) adStatus 值為 adStatusErrorsOccurred 時(shí)所發(fā)生的錯(cuò)誤，否則將不對(duì)它進(jìn)行設(shè)置。

adStatus   EventStatusEnum 狀態(tài)值。

當(dāng)調(diào)用 WillMove 時(shí)，如果引發(fā)事件的操作成功，則該參數(shù)設(shè)置為 adStatusOK。如果該方法無(wú)法請(qǐng)求取消掛起的操作，則設(shè)置為 adStatusCantDeny。

當(dāng)調(diào)用 MoveComplete 時(shí)，如果引發(fā)事件的操作成功，則該參數(shù)設(shè)置為 adStatusOK。如果操作失敗，則設(shè)置為 adStatusErrorsOccurred。

在 WillMove 返回前，將該參數(shù)設(shè)置為 adStatusCancel 可請(qǐng)求取消掛起的操作。在 MoveComplete 返回前，將該參數(shù)設(shè)置為 adStatusUnwantedEvent 可避免后續(xù)的通知。

pRecordset   Recordset 對(duì)象。發(fā)生該事件所針對(duì)的記錄集。

說(shuō)明

WillMove 或 MoveComplete 事件可因下列 Recordset 操作而發(fā)生：Open、Move、MoveFirst、MoveLast、MoveNext、MovePrevious、Bookmark、AddNew、Delete、Requery 和 Resync。這些事件可能因下列屬性而發(fā)生：Filter、Index、AbsolutePage 和 AbsolutePosition。如果子 Recordset 使 Recordset 事件被連接并且父 Recordset 被移動(dòng)，則也會(huì)發(fā)生這些事件。