ADOWillMoveおよび MoveCompleteイベント_
❮完全なレコードセットオブジェクトリファレンス
WillMoveイベント
WillMoveイベントは、操作がレコードセット内の現在の位置を変更する前にトリガーされます。
注:このイベントが戻る前に、statusパラメーターをadStatusCancelに設定してこのイベントの原因となった操作をキャンセルするか、adStatusUnwantedEventに設定して後続の通知を防止してください。
MoveCompleteイベント
MoveCompleteイベントは、レコードセット内の現在の位置が変更された後にトリガーされます。
注:このイベントが戻る前に、ステータスパラメーターをadStatusUnwantedEventに設定して、後続の通知を防止します。
注: WillMoveイベントまたはMoveCompleteイベントは、次のRecordsetメソッドのいずれかを呼び出すときに発生する可能性があります:Open、Move、MoveFirst、MoveLast、MoveNext、MovePrevious、AddNew、およびRequery。これらのイベントは、次のプロパティが原因で発生する場合もあります:Filter、Index、Bookmark、AbsolutePage、およびAbsolutePosition。
構文
WillMove reason,status,objRs
MoveComplete reason,objErr,status,objRs
Parameter | Description |
---|---|
reason | An EventReasonEnum value that specifies the reason for this event |
status | An EventStatusEnum value that indicates the status of the execution of the event |
objErr | The name of an Error object that describes the error if status is set to adStatusErrorsOccurred, otherwise it is not set |
objRs | The name of the Recordset object that triggered this event |
EventReasonEnum値
Constant | Value | Description |
---|---|---|
adRsnRequery | 7 | An operation requeried the Recordset |
adRsnMove | 10 | An operation moved the record pointer within the Recordset |
adRsnMoveFirst | 12 | An operation moved the record pointer to the first record in the Recordset |
adRsnMoveNext | 13 | An operation moved the record pointer to the next record in the Recordset |
adRsnMovePrevious | 14 | An operation moved the record pointer to the previous record in the Recordset |
adRsnMoveLast | 15 | An operation moved the record pointer to the last record in the Recordset |
EventStatusEnum値
Constant | Value | Description |
---|---|---|
adStatusOK | 1 | The operation that caused the event was successful |
adStatusErrorsOccurred | 2 | The operation that caused the event failed |
adStatusCantDeny | 3 | The operation that caused the event cannot be cancelled |
adStatusCancel | 4 | The operation that caused the event is cancelled |
adStatusUnwantedEvent | 5 | Prevents subsequent notifications before the event method has finished executing |
❮完全なレコードセットオブジェクトリファレンス