CDaoRecordView::OnMove

[アーティクル]
08/09/2011

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

virtual BOOL OnMove(
   UINT nIDMoveCommand 
);

パラメーター

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

戻り値

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

解説

既定の実装では、レコードビューに関連付けられた CDaoRecordset オブジェクトの適切な移動用のメンバー関数を呼び出します。

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

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

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

ヒント

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