Compartilhar via


CRecordView::OnMove

Chamar essa função de membro para mover para um registro diferente no conjunto de registros e exibir seus campos nos controles de exibição do registro.

virtual BOOL OnMove(
   UINT nIDMoveCommand 
);

Parâmetros

  • nIDMoveCommand
    Um dos seguintes valores padrão de identificação de comando:

    • Mudança deID_RECORD_FIRST para o primeiro registro no conjunto de registros.

    • Mudança deID_RECORD_LAST o último registro no conjunto de registros.

    • Mudança deID_RECORD_NEXT para o próximo registro no conjunto de registros.

    • Mudança deID_RECORD_PREV ao registro anterior no conjunto de registros.

Valor de retorno

Diferente de zero se mova tenha êxito; se não 0 se a solicitação de animação foi negada.

Comentários

A implementação padrão chama a função de membro apropriado de Mover do objeto de CRecordset associado com a exibição do registro.

Por padrão, OnMove atualizar o registro atual na fonte de dados se o usuário alterou a exibição do registro.

O assistente de aplicativo cria um recurso de menu com o primeiro registro, o registro do último, o próximo registro, e os itens de menu anterior do registro.Se você selecionar a opção encaixável da barra de ferramentas, o assistente do aplicativo também cria uma barra de ferramentas com botões que correspondem a esses comandos.

Se você mover o passado o último registro no conjunto de registros, a exibição do registro continua a exibir o último registro.Se você mover para trás após o primeiro registro, a exibição do registro continua a exibir o primeiro registro.

Observação de cuidadoCuidado

A chamada OnMove gera uma exceção se o recordset não tem nenhum registro.Chame a função apropriada do manipulador de atualização de interface do usuário — OnUpdateRecordFirst, OnUpdateRecordLast, OnUpdateRecordNext, ou OnUpdateRecordPrev — antes da operação correspondente de animação para determinar se o recordset ter quaisquer registros.

Exceções

Esse método pode lançar exceções do tipo CDBException*.

Requisitos

Cabeçalho: afxdb.h

Consulte também

Referência

Classe de CRecordView

Gráfico de hierarquia

CRecordset::Move