WillMove 및 MoveComplete 이벤트(ADO)
WillMove 이벤트는 보류 중인 작업이 레코드 집합의 현재 위치를 변경하기 전에 호출됩니다. MoveComplete 이벤트는 레코드 집합의 현재 위치가 변경된 후에 호출됩니다.
구문
WillMove adReason, adStatus, pRecordset
MoveComplete adReason, pError, adStatus, pRecordset
매개 변수
adReason
이 이벤트의 이유를 지정하는 EventReasonEnum 값입니다. 해당 값은 adRsnMoveFirst, adRsnMoveLast, adRsnMoveNext, adRsnMovePrevious, adRsnMove 또는 adRsnRequery일 수 있습니다.
pError
Error 개체입니다. adStatus 값이 adStatusErrorsOccurred인 경우 발생한 오류를 설명합니다. 그렇지 않으면 매개 변수가 설정되지 않습니다.
adStatus
EventStatusEnum 상태 값입니다.
WillMove가 호출되면 이벤트를 발생시킨 작업이 성공한 경우 이 매개 변수가 adStatusOK로 설정됩니다. 이 이벤트가 보류 중인 작업의 취소를 요청할 수 없는 경우 adStatusCantDeny로 설정됩니다.
MoveComplete가 호출되면 이벤트를 발생시킨 작업이 성공한 경우 이 매개 변수가 adStatusOK로 설정되고, 작업이 실패한 경우 adStatusErrorsOccurred로 설정됩니다.
WillMove가 반환되기 전에 이 매개 변수를 adStatusCancel로 설정하여 보류 중인 작업의 취소를 요청하거나 이 매개 변수를 adStatusUnwantedEvent로 설정하여 후속 알림을 방지합니다.
MoveComplete가 반환되기 전에 이 매개 변수를 adStatusUnwantedEvent로 설정하여 후속 알림을 방지합니다.
pRecordset
Recordset 개체입니다. 이 이벤트가 발생한 레코드 집합입니다.
설명
WillMove 또는 MoveComplete 이벤트는 Open, Move, MoveFirst, MoveLast, MoveNext, MovePrevious, AddNew, Requery레코드 집합 작업으로 인해 발생할 수 있습니다. 이러한 이벤트는 Filter, Index, Bookmark, AbsolutePage, AbsolutePosition 속성으로 인해 발생할 수 있습니다. 이러한 이벤트는 자식 레코드 집합에 레코드 집합 이벤트가 연결되어 있고 부모 레코드 집합이 이동한 경우에도 발생합니다.
adReason 매개 변수를 포함하는 모든 이벤트에 대한 이벤트 알림을 완전히 중지하려면 가능한 각 adReason 값에 대해 adStatus 매개 변수를 adStatusUnwantedEvent로 설정해야 합니다.