Eventos ADO WillMove e MoveComplete
❮ Referência Completa do Objeto do Conjunto de Registros
O evento WillMove
O evento WillMove é acionado antes de uma operação alterar a posição atual no Recordset.
Observação: antes que esse evento retorne, defina o parâmetro status como adStatusCancel para cancelar a operação que causou esse evento ou defina-o como adStatusUnwantedEvent para evitar notificações subsequentes.
O evento MoveComplete
O evento MoveComplete é acionado após a alteração da posição atual no Recordset.
Observação: antes que esse evento retorne, defina o parâmetro status como adStatusUnwantedEvent para evitar notificações subsequentes.
Observação: O evento WillMove ou MoveComplete pode ocorrer ao chamar um dos seguintes métodos Recordset: Open, Move, MoveFirst, MoveLast, MoveNext, MovePrevious, AddNew e Requery. Esses eventos também podem ocorrer devido às seguintes propriedades: Filter, Index, Bookmark, AbsolutePage e AbsolutePosition.
Sintaxe
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 |
Valores 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 |
Valores 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 |
❮ Referência Completa do Objeto do Conjunto de Registros