次の方法で共有

WillMove および MoveComplete イベント (ADO)

  • [アーティクル]

WillMove イベントは、保留中の操作が Recordset 内の現在の位置を変更する前に呼び出されます。 MoveComplete イベントは、Recordset 内の現在の位置が変更された後に呼び出されます。

構文

  
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 イベントは、Open、Move、MoveFirst、MoveLast、MoveNext、MovePrevious、AddNew、Requery の各 Recordset 操作が原因で発生する可能性があります。 これらのイベントは、Filter、Index、Bookmark、AbsolutePage、AbsolutePosition の各プロパティが原因で発生する可能性があります。 これらのイベントは、子 Recordset に Recordset イベントが接続されていて、親 Recordset が移動された場合にも発生します。

adReason パラメーターを含むイベントのイベント通知を完全に停止するには、adStatus パラメーターを adReason 値ごとに adStatusUnwantedEvent に設定する必要があります。

参照

ADO イベント モデルの例 (VC++)
ADO イベント ハンドラーの概要
Recordset オブジェクト (ADO)