WillMove イベントと MoveComplete イベント (ADO)

適用先: Access 2013、Office 2013

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

構文

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 オブジェクトです。

注釈

WillMove イベントまたは MoveComplete イベントは、次の Recordset 操作が原因で発生する可能性があります。

• Open
• 移動
• MoveFirst
• MoveLast
• MoveNext
• MovePrevious
• AddNew
• Requery

これらのイベントは、次のプロパティが原因で発生する可能性があります。

• フィルター
• インデックス
• Bookmark
• AbsolutePage
• AbsolutePosition

これらのイベントは、子 Recordset に Recordset イベントが関連付けられているときに親 Recordset が移動した場合にも発生します。

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