Поделиться через


CRecordView::OnMove

Эта функция-член вызывается, чтобы перейти к другой записи в наборе записей и отобразить ее поля в элементах управления запись представления.

virtual BOOL OnMove( 
   UINT nIDMoveCommand  
);

Параметры

  • nIDMoveCommand
    Одно из следующих стандартных значений идентификатора команды:

    • Перемещение ID_RECORD_FIRST к первой записи в наборе записей.

    • Перемещение ID_RECORD_LAST к последней записи в наборе записей.

    • Перемещение ID_RECORD_NEXT к следующей записи в наборе записей.

    • Перемещение ID_RECORD_PREV к предыдущей записи в наборе записей.

Возвращаемое значение

Ненулевой, если перемещение выполнено успешно; в противном случае – значение 0, если запрос был запрет перемещения.

Заметки

Реализация по умолчанию вызывает соответствующий функцию-член Переместить объекта CRecordset, связанного с представлением записи.

По умолчанию OnMove обновляет текущую запись в источнике данных, если пользователь изменил его в представлении записей.

Мастер приложений создает ресурс меню с первой записью, записью последнего следующими точками меню записи и обратно запись. Если выбран параметр закрепляемых Панелей инструментов, то мастер приложений также создает панель инструментов с кнопками, соответствующий этим командам.

Если переместить за последней записи в наборе записей, то представление записей продолжает отображать последнюю запись. При перемещении отсталое за первой записью, представление записей продолжает отображать первую запись.

Предупреждение

Вызов OnMove создает исключение, если набор записей не содержит записей.Вызовите нужную функцию обработчика обновления пользовательского интерфейса — OnUpdateRecordFirst, OnUpdateRecordLast, OnUpdateRecordNext или OnUpdateRecordPrev — прежде, чем соответствующий операция move, чтобы определить, имеет ли набор записей какие-либо записи.

Исключения

Этот метод может создавать исключения типа CDBException*.

Требования

Header: afxdb.h

См. также

Ссылки

Класс CRecordView

Диаграмма иерархии

CRecordset::Move