CDaoRecordView::OnMove

virtual BOOL OnMove( UINT nIDMoveCommand );

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:

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 CDaoRecordset 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 Initial 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 Overview: Creating a Program That Supports a Database in Visual C++ Programmer's Guide.

CDaoRecordView OverviewClass MembersHierarchy Chart

See Also   CDaoRecordset::Move