Eventos WillMove e MoveComplete (ADO)

O evento WillMove é chamado antes que uma operação pendente altere a posição atual no Conjunto de Registros. O evento MoveComplete é chamado depois que a posição atual no Conjunto de Registros é alterada.

Sintaxe

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

Parâmetros

adReason
Um valor EventReasonEnum que especifica o motivo desse evento. Seu valor pode ser adRsnMoveFirst, adRsnMoveLast, adRsnMoveNext, adRsnMovePrevious, adRsnMove ou adRsnRequery.

pError
Um objeto Error. Ele descreve o erro que ocorreu se o valor de adStatus for adStatusErrorsOccurred; caso contrário, o parâmetro não está definido.

adStatus
Um valor de status EventStatusEnum.

Quando WillMove é chamado, esse parâmetro é definido como adStatusOK se a operação que causou o evento foi bem-sucedida. Ele será definido como adStatusCantDeny se esse evento não puder solicitar o cancelamento da operação pendente.

Quando MoveComplete é chamado, esse parâmetro é definido como adStatusOK se a operação que causou o evento foi bem-sucedida ou para adStatusErrorsOccurred se a operação falhou.

Antes de WillMove retornar, defina esse parâmetro como adStatusCancel para solicitar o cancelamento da operação pendente ou defina esse parâmetro como adStatusUnwantedEvent para evitar notificações subsequentes.

Antes que MoveComplete retorne, defina esse parâmetro como adStatusUnwantedEvent para evitar notificações subsequentes.

pRecordset
Um objeto Recordset. O conjunto de registros para o qual esse evento ocorreu.

Observações

Um evento WillMove ou MoveComplete pode ocorrer devido às seguintes operações do Recordset : Open, Move, MoveFirst, MoveLast, MoveNext, MovePrevious, AddNew e Requery. Esses eventos podem ocorrer devido às seguintes propriedades: Filter, Index, Bookmark, AbsolutePage e AbsolutePosition. Esses eventos também ocorrem se um conjunto de registros filho tiver eventos recordset conectados e o conjunto de registros pai for movido.

Você deve definir o parâmetro adStatus como adStatusUnwantedEvent para cada valor adReason possível para interromper completamente a notificação de evento para qualquer evento que inclua um parâmetro adReason .

Consulte Também

exemplo de modelo de eventos do ADO (VC++)
resumo do manipulador de eventos do ADO
do objeto Recordset (ADO)