RAD Studio VCL Reference
ContentsIndex
PreviousUpNext
TDataLink.MoveBy Method

Repositions the dataset to another record relative to its active record.

Pascal
function MoveBy(Distance: Integer): Integer; virtual;
C++
virtual __fastcall int MoveBy(int Distance);

The MoveBy record changes the active record in the associated dataset, based on the Distance parameter. If Distance is greater than 0, MoveBy causes the dataset to move forward by that number of records. If Distance is less than 0, MoveBy causes the dataset to move backward. MoveBy returns the number of records actually moved (which may be less than the absolute value of Distance if the dataset encountered the first or last record before moving the indicated number of records). 

MoveBy calls the MoveBy method of the associated dataset. 

 

Copyright(C) 2009 Embarcadero Technologies, Inc. All Rights Reserved.
What do you think about this topic? Send feedback!