Share via

Classe CCtrlView

  • Artigo

Adapta a arquitetura de exibição de documento aos controles comuns compatíveis com o Windows 98 e Windows NT versões 3.51 e posteriores.

Sintaxe

class CCtrlView : public CView

Membros

Construtores públicos

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

Métodos protegidos

Nome Descrição
CCtrlView::OnDraw Chamado pela estrutura para desenhar usando o contexto de dispositivo especificado.
CCtrlView::PreCreateWindow Chamado antes da criação da janela do Windows anexada a esse objeto CCtrlView.

Membros de Dados Protegidos

Nome Descrição
CCtrlView::m_dwDefaultStyle Contém o estilo padrão para a classe de exibição.
CCtrlView::m_strClass Contém o nome da classe do Windows para a classe de exibição.

Comentários

A classe CCtrlView e seus derivados, CEditView, CListView, CTreeView e CRichEditView, adaptam a arquitetura de exibição de documento aos novos controles comuns compatíveis com o Windows 95/98 e Windows NT versões 3.51 e posteriores. Para obter mais informações sobre a arquitetura de exibição de documento, consulte Documento/Arquitetura de exibição.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CView

CCtrlView

Requisitos

Cabeçalho: afxwin.h

CCtrlView::CCtrlView

Constrói um objeto CCtrlView.

CCtrlView(
    LPCTSTR lpszClass,
    DWORD dwStyle);

Parâmetros

lpszClass
Nome de classe do Windows da classe de exibição.

dwStyle
Estilo da classe de exibição.

Comentários

A estrutura chama o construtor quando uma nova janela de quadro é criada ou uma janela é dividida. Substitua CView::OnInitialUpdate para inicializar o modo de exibição depois que o documento for anexado. Chame CWnd::Create ou CWnd::CreateEx para criar o objeto do Windows.

CCtrlView::m_strClass

Contém o nome da classe do Windows para a classe de exibição.

CString m_strClass;

CCtrlView::m_dwDefaultStyle

Contém o estilo padrão para a classe de exibição.

DWORD m_dwDefaultStyle;

Comentários

Esse estilo é aplicado quando uma janela é criada.

CCtrlView::OnDraw

Chamado pela estrutura para desenhar o conteúdo do objeto CCtrlView usando o contexto de dispositivo especificado.

virtual void OnDraw(CDC* pDC);

Parâmetros

pDC
Um ponteiro para o contexto do dispositivo no qual acontece o desenho.

Comentários

OnDraw normalmente é chamado para exibição de tela, passando um contexto de dispositivo de tela especificado pelo pDC.

CCtrlView::PreCreateWindow

Chamado antes da criação da janela do Windows anexada a esse objeto CWnd.

virtual BOOL PreCreateWindow(CREATESTRUCT& cs);

Parâmetros

cs
Uma estrutura CREATESTRUCT.

Valor de Devolução

Diferente de zero se a criação da janela deve continuar; 0 para indicar falha de criação.

Comentários

Nunca chame essa função diretamente.

A implementação padrão dessa função verifica o nome de uma classe de janela NULL e substitui um padrão apropriado. Substitua essa função membro para modificar a estrutura CREATESTRUCT antes que a janela seja criada.

Cada classe derivada por CCtrlView adiciona sua própria funcionalidade à sua substituição de PreCreateWindow. Por design, essas derivações de PreCreateWindow não são documentadas. Para determinar os estilos apropriados para cada classe e as interdependências entre os estilos, você pode examinar o código-fonte MFC para a classe base do aplicativo. Se você optar por substituir PreCreateWindow, poderá determinar se os estilos usados na classe base do aplicativo fornecem a funcionalidade necessária usando informações coletadas do código-fonte MFC.

Para obter mais informações sobre como alterar estilos de janela, consulte Alteração dos estilos de uma janela criada pelo MFC.

Confira também

Classe CView
Gráfico da hierarquia
Classe CTreeView
Classe CListView
Classe CRichEditView