События ADO WillMove и MoveComplete
❮ Полная ссылка на объект набора записей
Событие WillMove
Событие WillMove запускается до того, как операция изменяет текущую позицию в наборе записей.
Примечание. Перед возвратом этого события установите для параметра состояния значение 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 |
❮ Полная ссылка на объект набора записей