Classe CView

Artigo
06/10/2015

Fornece a funcionalidade básica para classes definidas pelo usuário de exibição.

class AFX_NOVTABLE CView : public CWnd

Membros

Construtores protegidos

Nome	Descrição
CView::CView	Constrói um objeto de CView .

Métodos públicos

Nome	Descrição
CView::DoPreparePrinting	Exibe imprimem a caixa de diálogo e cria o contexto do dispositivo de impressora; chamada para substituir a função de membro de OnPreparePrinting .
CView::GetDocument	Retorna o documento associado com a exibição.
CView::IsSelected	Testa se um item do documento está selecionado. Necessário para suporte OLE.
CView::OnDragEnter	Chamado quando um item é arrastado primeiro na região de arrastar e soltar de uma exibição.
CView::OnDragLeave	Chamado quando um item arrastado deixar a região de arrastar e soltar de uma exibição.
CView::OnDragOver	Chamado quando um item é arrastado sobre a região de arrastar e soltar de uma exibição.
CView::OnDragScroll	Chamado para determinar se o cursor é arrastado na região de rolagem da janela.
CView::OnDrop	Chamado quando um item é solto na região de arrastar e soltar de uma exibição, manipulador padrão.
CView::OnDropEx	Chamado quando um item é solto na região de arrastar e soltar de uma exibição, manipulador primária.
CView::OnInitialUpdate	Chamado depois que uma visualização é anexada a primeira um documento.
CView::OnPrepareDC	Chamado antes que a função de membro de OnDraw é chamada para a exibição ou a função de membro de OnPrint é chamado para imprimir ou visualização de impressão.
CView::OnScroll	Chamado quando itens são arrastados VELHOS além das bordas de exibição.
CView::OnScrollBy	Chamado quando uma exibição que contém itens VELHOS no lugar ativos é rolada.

Métodos protegidos

Nome	Descrição
CView::OnActivateFrame	Chamado quando a janela de quadro chave que contém a exibição é ativada ou desativada.
CView::OnActivateView	Chamado quando uma exibição é ativada.
CView::OnBeginPrinting	Chamado quando um trabalho de impressão começarem; substitua para atribuir recursos de (GDI) da interface de dispositivo gráficos.
CView::OnDraw	Chamado para processar uma imagem do documento para a exibição, impressão, ou a visualização de impressão. Implementação necessária.
CView::OnEndPrinting	Chamado quando um trabalho de impressão terminarem; substituição desalocar recursos do GDI.
CView::OnEndPrintPreview	Chamado quando o modo de visualização é saído.
CView::OnPreparePrinting	Chamado antes que um documento é impresso ou visualizado; substituição para inicializar a caixa de diálogo de impressão.
CView::OnPrint	Chamado para visualizar impressão ou uma página do documento.
CView::OnUpdate	Chamado para notificar uma exibição que seu documento foi alterado.

Comentários

Uma visualização é anexado a um documento e atua como intermediário entre o documento e o usuário: a exibição processa uma imagem do documento na tela ou a impressora e interpreta a entrada do usuário como operações em cima do documento.

Uma visualização é um filho de uma janela do quadro. Mais de uma exibição pode compartilhar uma janela de quadro, como no caso de uma janela separator. A relação entre uma classe de visualização, uma classe de janela do quadro, e uma classe de documento é estabelecida por um objeto de CDocTemplate . Quando o usuário abre uma nova janela ou divide existente, a estrutura constrói um novo modo de exibição e anexá-la ao documento.

Uma exibição pode ser anexada a apenas um documento, mas um documento pode ter múltiplas visualizações anexadas a ele imediatamente — por exemplo, se o documento é exibido em uma janela do separador ou em várias janelas filho em um aplicativo de (MDI) de interface de documentos múltiplos. Seu aplicativo pode oferecer suporte a diferentes tipos de exibição para um tipo de dado documento; por exemplo, um programa de processamento de texto pode fornecer uma exibição de texto completo de um documento e um contorno exibe que mostra somente os títulos da seção. Esses tipos diferentes de exibição podem ser colocados no windows separadas do quadro ou nos painéis separados de uma única janela do quadro se você usar uma janela separator.

Uma exibição pode ser responsável para manipular vários tipos diferentes de entrada, como a entrada do teclado, a entrada do mouse ou entrada através de arrastar-e-soltar, bem como os comandos de menus, barras de ferramentas, ou as barras de rolagem. Uma exibição recebe os comandos encaminhados por sua janela do quadro. Se a exibição não trata um determinado comando, encaminha o comando no seu documento associado. Como qualquer alvo do comando, uma exibição trata mensagens através de um mapa de mensagem.

Modo é responsável para exibir e modificar os dados do documento mas não para armazená-lo. O documento oferece a exibição com os detalhes necessários sobre seus dados. Você pode deixar os membros de dados acesso de exibição de documentos diretamente, ou você pode fornecer funções de membro na classe do documento para a classe de visualização a chamada.

Quando os dados de um documento for alterado, a exibição responsável pelas alterações normalmente chama a função de CDocument::UpdateAllViews para o documento, que notifica todas as outras visualizações chamar a função de membro de OnUpdate para cada um. A implementação padrão de OnUpdate invalida toda a área cliente de exibição. Você pode substituí-la para invalidar apenas essas regiões da área cliente que mapeiam as partes alteradas do documento.

Para usar CView, derive uma classe de ele e implementar a função de membro de OnDraw para executar a exibição. Você também pode usar OnDraw para executar a impressão e a visualização de impressão. A estrutura trata o loop de impressão para impressão e visualizar o documento.

Uma exibição trata mensagens de barra de rolagem com as funções de membro de CWnd::OnHScroll e de CWnd::OnVScroll . Você pode implementar tratamento de mensagem barra de rolagem em essas funções, ou você pode usar a classe derivada CScrollView de CView para manipular a rolagem para você.

Além de CScrollView, a biblioteca de classes de base do Microsoft fornece outras nove classes derivadas de CView:

CCtrlView, uma exibição que permite o uso de documento - exibir a arquitetura com árvore, a lista, e controles de edição ricos.
CDaoRecordView, uma exibição que exibe registros do banco de dados na caixa de diálogo controles.
CEditView, uma exibição que fornece um editor de texto simples de várias linhas. Você pode usar um objeto de CEditView como um controle em uma caixa de diálogo assim como em uma exibição em um documento.
CFormView, uma exibição de rolagem que contém controles de caixa de diálogo e é baseada em um recurso do modelo da caixa de diálogo.
CListView, uma exibição que permite o uso de documento - exibir a arquitetura com controles de lista.
CRecordView, uma exibição que exibe registros do banco de dados na caixa de diálogo controles.
CRichEditView, uma exibição que permite o uso de documento - exibir a arquitetura com controles de edição ricos.
CScrollView, uma exibição que fornece automaticamente suporte de rolagem.
CTreeView, uma exibição que permite o uso de documento - exibir a arquitetura com controles de árvore.

A classe de CView também tem uma classe derivada de implementação chamada CPreviewView, que é usada pela estrutura para executar visualizar impressão. Essa classe fornece suporte para recursos exclusivos para a janela de visualização de impressão, como uma barra de ferramentas, visualização um único ou da página, e zoom, isto é, ampliando a imagem visualizado. Você não precisa chamar ou substituir algumas das funções de membro de CPreviewView a menos que você queira implementar sua própria interface para a visualização de impressão (por exemplo, se você deseja oferecer suporte à edição no modo de visualização de impressão). Para obter mais informações sobre como usar CView, consulte Arquitetura do documento/exibição e Imprimindo. Além de isso, consulte Observe técnica 30 para mais detalhes sobre personalizar a visualização de impressão.