Classe COleDBRecordView

Um modo de exibição que exibe registros de banco de dados em controles.

Sintaxe

class COleDBRecordView : public CFormView

Membros

Construtores Protegidos

Métodos Públicos

Observações

A vista é uma vista de forma diretamente ligada a um CRowset objeto. A vista é criada a partir de um recurso de template de diálogo e apresenta os campos do CRowset objeto nos controlos do template de diálogo. O COleDBRecordView objeto utiliza a troca de dados de diálogo (DDX) e a funcionalidade de navegação incorporada em CRowset, para automatizar a movimentação de dados entre os controlos do formulário e os campos do conjunto de linhas. COleDBRecordView também fornece uma implementação padrão para mover para o primeiro, próximo, anterior ou último registo e uma interface para atualizar o registo atualmente em visualização.

Podes usar funções DDX com COleDbRecordView para obter dados diretamente do conjunto de registos da base de dados e exibi-los num controlo de diálogo. Deve usar os DDX_* métodos (como DDX_Text), e não as DDX_Field* funções (como DDX_FieldText) com COleDbRecordView. DDX_FieldText não funcionará com COleDbRecordView porque DDX_FieldText toma um argumento adicional do tipo CRecordset* (para CRecordView) ou CDaoRecordset* (para CDaoRecordView).

COleDBRecordView mantém o acompanhamento da posição do utilizador no conjunto de linhas para que a vista de registo possa atualizar a interface do utilizador. Quando o utilizador se move para qualquer extremidade do conjunto de linhas, a vista de registo desativa objetos da interface do utilizador — como itens do menu ou botões da barra de ferramentas — para avançarem na mesma direção.

Para mais informações sobre classes de conjuntos de linhas, consulte o artigo Utilização de Modelos de Consumo do OLE DB .

Hierarquia de herança

CObject

CCmdTarget

CWnd

CView

CScrollView

CFormView

COleDBRecordView

Requerimentos

Cabeçalho: afxoledb.h

COleDBRecordView::COleDBRecordView

Constrói um COleDBRecordView objeto.

COleDBRecordView(LPCTSTR lpszTemplateName);
COleDBRecordView(UINT nIDTemplate);

Parâmetros

lpszTemplateName
Contém uma cadeia terminada por null que é o nome de um recurso de template de diálogo.

nIDTemplate
Contém o número ID de um recurso de template de diálogo.

Observações

Quando crias um objeto de um tipo derivado de COleDBRecordView, invoca um dos construtores para criar o objeto view e identificar o recurso de diálogo em que a view se baseia. Pode identificar o recurso pelo nome (passar uma string como argumento ao construtor) ou pelo seu ID (passar um inteiro sem sinal como argumento).

COleDBRecordView::OnGetRowSet

Devolve um handle para o objeto CRowset<> associado à visualização de registos.

virtual CRowset<>* OnGetRowset() = 0;

Valor de retorno

Um valor HRESULT padrão.

Observações

Deve sobrescrever esta função membro para construir ou obter um objeto de conjunto de linhas e devolver um handle a ele. Se declarares a tua classe de visualização de registos com o ClassWizard, o assistente escreve um override por defeito para ti. A implementação padrão do ClassWizard devolve o handler de conjunto de linhas armazenado na vista de registos, caso exista. Se não, constrói um objeto de conjunto de linhas do tipo que especificaste com o ClassWizard e chama a sua Open função membro para abrir a tabela ou executar a consulta, e depois devolve um handle ao objeto.

Example

CFrameWnd* pFrame = (CFrameWnd*)AfxGetMainWnd();
COleDBRecordView* pView = (COleDBRecordView*)pFrame->GetActiveView();

// CProductAccessor is a user-defined accessor class
CRowset<CAccessor<CProductAccessor>>* pRowSet =
(CRowset<CAccessor<CProductAccessor>>*)pView->OnGetRowset();

Para mais informações e exemplos, consulte o artigo Visualizações de Registo: Utilização de uma Visualização de Registo.

COleDBRecordView::OnMove

Move-se para um registo diferente no conjunto de linhas e apresenta os seus campos nos controlos da vista de registo.

virtual BOOL OnMove(UINT nIDMoveCommand);

Parâmetros

nIDMoveCommand
Um dos seguintes valores padrão de ID de comando:

• ID_RECORD_FIRST — Avançar para o primeiro registo do conjunto de registos.

• ID_RECORD_LAST — Avance para o último registo do conjunto de registos.

• ID_RECORD_NEXT — Passar para o próximo registo no conjunto de registos.

• ID_RECORD_PREV — Avance para o registo anterior no conjunto de registos.

Valor de retorno

Não zero se a jogada fosse bem-sucedida; caso contrário, 0 se o pedido de mudança for recusado.

Observações

A implementação padrão chama a função membro apropriada Move do CRowset objeto associada à vista de registo.

Por defeito, OnMove atualiza o registo atual na fonte de dados se o utilizador o tiver alterado na vista de registo.

O Assistente de Aplicação cria um recurso de menu com os itens do menu Primeiro Registo, Último Registo, Próximo Registo e Registo Anterior. Se selecionar a opção Barra de Ferramentas Acoplável, o Assistente de Aplicações também cria uma barra de ferramentas com botões correspondentes a estes comandos.

Se ultrapassar o último registo no conjunto de registos, a vista de registo continua a mostrar o último registo. Se recuar para além do primeiro registo, a visualização de registo continua a mostrar o primeiro registo.

Consulte também

Gráfico de Hierarquia