| True DataControl 8.0 Reference > True DataControl Control > TData Control Events > MoveComplete Event |
MoveComplete Event
Occurs after the current row position has changed.
TData_MoveComplete (ByVal adReason As EventReasonEnum, ByVal pError As ADODB.Error, adStatus As EventStatusEnum)
Arguments: adReason is an ADO EventReasonEnum value that specifies the reason for this event. Its value can beadRsnMoveFirst, adRsnMoveLast, adRsnMoveNext, adRsnMovePrevious, adRsnMove, or adRsnRequery.
adStatus is an ADO EventStatusEnum status variable. When MoveComplete is called, this parameter is set toadStatusOK if the operation that caused the event was successful, or adStatusErrorsOccurred if the operation failed.
The MoveComplete event is a standard ADO Recordset event fired by the TData control’s Recordset. For more information, see Using recordset events. As with any ADO recordset, this event occurs after a pending operation changes the current position in the recordset. For the TData control, it means that the current row position of the control changes, the control is repositioned to a different row.
The MoveComplete event is also fired when an operation has attempted to change the current row position, and failed. This case can be detected by the value of the adStatus argument, it is set to adStatusErrorsOccurred if the operation failed.
The MoveComplete event may occur due to the following Recordset operations: Open, Move, MoveFirst, MoveLast, MoveNext, MovePrevious, Bookmark, AddNew, Delete, Requery, and Resync.
Note: The WillMove and MoveComplete events also occur for a child recordset (in a recordset hierarchy) when its parent recordset is repositioned. The adReason value is adRsnRequery.
See Also