Peristiwa WillMove dan MoveComplete (ADO)

Peristiwa WillMove dipanggil sebelum operasi yang tertunda mengubah posisi saat ini di Recordset. Peristiwa MoveComplete dipanggil setelah posisi saat ini di Recordset berubah.

Sintaks

  
WillMove adReason, adStatus, pRecordset  
MoveComplete adReason, pError, adStatus, pRecordset  

Parameter

adReason
Nilai EventReasonEnum yang menentukan alasan kejadian ini. Nilainya bisa adRsnMoveFirst, adRsnMoveLast, adRsnMoveNext, adRsnMovePrevious, adRsnMove, atau adRsnRequery.

pError
Objek Kesalahan . Ini menjelaskan kesalahan yang terjadi jika nilai adStatus adalah adStatusErrorsOccurred; jika tidak, parameter tidak diatur.

adStatus
Nilai status EventStatusEnum .

Ketika WillMove dipanggil, parameter ini diatur ke adStatusOK jika operasi yang menyebabkan peristiwa berhasil. Ini diatur ke adStatusCantDeny jika kejadian ini tidak dapat meminta pembatalan operasi yang tertunda.

Ketika MoveComplete dipanggil, parameter ini diatur ke adStatusOK jika operasi yang menyebabkan peristiwa berhasil, atau ke adStatusErrorsOccurred jika operasi gagal.

Sebelum WillMove kembali, atur parameter ini ke adStatusCancel untuk meminta pembatalan operasi yang tertunda, atau atur parameter ini ke adStatusUnwantedEvent untuk mencegah pemberitahuan berikutnya.

Sebelum MoveComplete kembali, atur parameter ini ke adStatusUnwantedEvent untuk mencegah pemberitahuan berikutnya.

pRecordset
Objek Recordset . Recordset tempat kejadian ini terjadi.

Keterangan

Peristiwa WillMove atau MoveComplete dapat terjadi karena operasi Recordset berikut: Buka, Pindahkan, MoveFirst, MoveLast, MoveNext, MovePrevious, AddNew, dan Requery. Peristiwa ini dapat terjadi karena properti berikut: Filter, Indeks, Bookmark, AbsolutePage, dan AbsolutePosition. Peristiwa ini juga terjadi jika Recordset anak memiliki peristiwa Recordset yang tersambung dan Recordset induk dipindahkan.

Anda harus mengatur parameter adStatus ke adStatusUnwantedEvent untuk setiap nilai adReason yang mungkin untuk sepenuhnya menghentikan pemberitahuan peristiwa untuk setiap peristiwa yang menyertakan parameter adReason .

Lihat juga

Contoh Model Peristiwa ADO (VC++)
Ringkasan Penanganan Aktivitas ADO
Objek Recordset (ADO)