CRecordView::OnMove

Artikel
02/26/2013

Rufen Sie die Memberfunktion auf, um zu einem anderen Datensatz im Recordset zu navigieren und die zugehörigen Felder in den Steuerelementen der Datensatzansicht anzuzeigen.

virtual BOOL OnMove(
   UINT nIDMoveCommand 
);

Parameter

nIDMoveCommand
Einer der folgenden Standardbefehls-id-Werte:
- ID_RECORD_FIRST Verschiebung zum ersten Datensatz des Recordsets.
- ID_RECORD_LAST Verschiebung zum letzten Datensatz im Recordset.
- ID_RECORD_NEXT Verschiebung zum nächsten Datensatz des Recordsets.
- ID_RECORD_PREV Verschiebung zum vorherigen Datensatz des Recordsets.

Rückgabewert

Ungleich 0 (null), wenn die Verschiebung erfolgreich war; andernfalls 0, wenn die Verschiebungsanforderung verweigert wurde.

Hinweise

Die Standardimplementierung ruft die entsprechende MoveCRecordset-Memberfunktion des Objekts auf, das der Datensatzansicht zugeordnet ist.

Standardmäßig aktualisiert OnMove den aktuellen Datensatz der Datenquelle, wenn der Benutzer sie in der Datensatzansicht geändert hat.

Der Anwendungs-Assistent erstellt eine Menüressource mit dem ersten Datensatz, letztem Datensatz, nächstem und vorherigen Datensatz Rekordmenüelementen.Wenn Sie die andockbare Symbolleistenoption auswählen, stellt der Anwendungs-Assistent auch eine Symbolleiste mit Schaltflächen entsprechend diesen Befehlen erstellt.

Wenn Sie über den letzten Datensatz des Recordsets wechseln, wird die Datensatzansicht fort, um den letzten Datensatz anzuzeigen.Wenn Sie rückwärts hinter dem ersten Datensatz verschieben, wird die Datensatzansicht fort, um den ersten Datensatz anzuzeigen.

Vorsicht
OnMove dazu, löst eine Ausnahme aus, wenn das Recordset keine Datensätze verfügt.Rufen Sie die entsprechende Benutzeroberflächenaktualisierungshandlerfunktion - OnUpdateRecordFirst, OnUpdateRecordLast, OnUpdateRecordNext oder OnUpdateRecordPrev - bevor der entsprechende Verschiebungsvorgang auf, um zu bestimmen, ob das Recordset alle Datensätze verfügt.