CRecordView::OnMove

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

レコードセット内の別のレコードに移動し、レコードビューのコントロールにそのレコードのフィールドを表示します。

virtual BOOL OnMove(
   UINT nIDMoveCommand 
);

パラメータ

nIDMoveCommand
次の標準コマンド ID 値の 1 つを指定します。
- ID_RECORD_FIRST レコードセットの先頭レコードに移動します。
- ID_RECORD_LAST レコードセットの最終レコードに移動します。
- ID_RECORD_NEXT レコードセットの次のレコードに移動します。
- ID_RECORD_PREV レコードセットの前のレコードに移動します。

戻り値

移動できた場合は 0 以外を返します。移動要求が拒否された場合は 0 を返します。

解説

この関数の既定の実装では、レコードビューに関連付けられている CRecordset オブジェクトの適切な Move メンバ関数を呼び出します。

既定では、ユーザーがレコードビューで現在のレコードを変更すると、OnMove 関数がデータソースの現在のレコードを更新します。

アプリケーションウィザードは、先頭レコード、最終レコード、次のレコード、前のレコードをメニュー項目としてメニューリソースを作成します。[ドッキングツールバー] チェックボックスをオンにすると、アプリケーションウィザードもこれらのコマンドに対応するボタンを持つツールバーを作成します。

レコードセットの最終レコードを超えて移動した場合は、レコードビューでは最終レコードが表示されたままの状態になります。先頭レコードを越えて移動した場合、レコードビューでは先頭レコードが表示されたたままの状態になります。

注意 :
レコードセットがレコードを持たないとき、OnMove 関数を呼び出すと例外をスローします。移動の操作の前にレコードセットがレコードを持つかどうかを調べるために、それぞれの移動に対応するユーザーインターフェイス更新ハンドラ関数 OnUpdateRecordFirst、OnUpdateRecordLast、OnUpdateRecordNext、OnUpdateRecordPrev を呼び出します。

レコードセットがレコードを持たないとき、OnMove 関数を呼び出すと例外をスローします。移動の操作の前にレコードセットがレコードを持つかどうかを調べるために、それぞれの移動に対応するユーザーインターフェイス更新ハンドラ関数 OnUpdateRecordFirst、OnUpdateRecordLast、OnUpdateRecordNext、OnUpdateRecordPrev を呼び出します。