ADO WillMove and MoveComplete الأحداث
استكمال مرجع كائن مجموعة السجلات
حدث WillMove
يتم تشغيل حدث WillMove قبل أن تغير العملية الموضع الحالي في مجموعة السجلات.
ملاحظة: قبل عودة هذا الحدث ، قم بتعيين معلمة الحالة على adStatusCancel لإلغاء العملية التي تسببت في هذا الحدث أو تعيينها على adStatusUnwantedEvent لمنع الملاحظات اللاحقة.
حدث MoveComplete
يتم تشغيل حدث MoveComplete بعد تغيير الموضع الحالي في مجموعة السجلات.
ملاحظة: قبل عودة هذا الحدث ، اضبط معلمة الحالة على adStatusUnwantedEvent لمنع الإشعارات اللاحقة.
ملاحظة: قد يقع حدث WillMove أو حدث MoveComplete عند استدعاء أحد أساليب Recordset التالية: Open و Move و MoveFirst و MoveLast و MoveNext و MovePrevious و AddNew و Requery. قد تحدث هذه الأحداث أيضًا بسبب الخصائص التالية: عامل التصفية والفهرس والإشارة المرجعية و 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 |
استكمال مرجع كائن مجموعة السجلات