Share via

CRecordView::OnMove

  • Article

virtualBOOLOnMove(UINTnIDMoveCommand**);**
throw(CDBException);

Return Value

Nonzero if the move was successful; otherwise 0 if the move request was denied.

Parameters

nIDMoveCommand

One of the following standard command ID values:

  • ID_RECORD_FIRST   Move to the first record in the recordset.

  • ID_RECORD_LAST   Move to the last record in the recordset.

  • ID_RECORD_NEXT   Move to the next record in the recordset.

  • ID_RECORD_PREV   Move to the previous record in the recordset.

Remarks

Call this member function to move to a different record in the recordset and display its fields in the controls of the record view. The default implementation calls the appropriate Move member function of the CRecordset object associated with the record view.

By default, OnMove updates the current record on the data source if the user has changed it in the record view.

AppWizard creates a menu resource with First Record, Last Record, Next Record, and Previous Record menu items. If you select the Dockable Toolbar option, AppWizard also creates a toolbar with buttons corresponding to these commands.

If you move past the last record in the recordset, the record view continues to display the last record. If you move backward past the first record, the record view continues to display the first record.

Caution   Calling OnMove throws an exception if the recordset has no records. Call the appropriate user interface update handler function — OnUpdateRecordFirst, OnUpdateRecordLast, OnUpdateRecordNext, or OnUpdateRecordPrev — before the corresponding move operation to determine whether the recordset has any records. For information about the update handlers, see in Visual C++ Programmer’s Guide.

CRecordView Overview |  Class Members |  Hierarchy Chart

See Also   CRecordset::Move