Partager via


CRecordView::OnMove

Appelez la fonction membre pour passer à un autre enregistrement du recordset et afficher ses champs dans les contrôles de la vue de l'enregistrement.

virtual BOOL OnMove( 
   UINT nIDMoveCommand  
);

Paramètres

  • nIDMoveCommand
    L'une des valeurs standard suivantes d'ID de commande :

    • Déplacement d'ID_RECORD_FIRST au premier enregistrement du recordset.

    • Déplacement d'ID_RECORD_LAST au dernier enregistrement du recordset.

    • Déplacement d'ID_RECORD_NEXT à l'enregistrement du recordset.

    • Déplacement d'ID_RECORD_PREV à l'enregistrement précédent dans le recordset.

Valeur de retour

Une valeur différente de zéro si le déplacement a réussi ; sinon 0 si la demande de déplacement est refusée.

Notes

L'implémentation par défaut appelle la fonction membre appropriée de Déplacer de l'objet d' CRecordset associé à la vue de l'enregistrement.

Par défaut, OnMove met l'enregistrement en cours sur la source de données si l'utilisateur a modifié dans la vue de l'enregistrement.

L'Assistant Application crée une ressource menu avec le premier enregistrement, l'enregistrement de bout, l'enregistrement suivant, et les éléments de menu d'enregistrement précédent. Si vous sélectionnez l'option ancrable de barre d'outils, l'Assistant Application crée également une barre d'outils avec des boutons correspondant à ces commandes.

Si vous déplacez au delà de le dernier enregistrement du recordset, la vue de l'enregistrement continue à afficher le dernier enregistrement. Si vous déplacez vers l'arrière après le premier enregistrement, la vue de l'enregistrement continue à afficher le premier enregistrement.

Avertissement

Appelant OnMove lève une exception si le recordset n'a aucun enregistrement.Appelez la fonction appropriée du gestionnaire de mise à jour de l'interface utilisateur — OnUpdateRecordFirst, OnUpdateRecordLast, OnUpdateRecordNext, ou OnUpdateRecordPrev — avant que l'opération correspondante de déplacement pour déterminer si le recordset contient les enregistrements.

Exceptions

Cette méthode peut lever des exceptions de type CDBException*.

Configuration requise

Header: afxdb.h

Voir aussi

Référence

CRecordView, classe

Graphique de la hiérarchie

CRecordset::Move