Classe CFormView

A classe base usada para exibições de formulário.

Sintaxe

class CFormView : public CScrollView

Membros

Construtores Protegidos

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

Métodos públicos

Nome	Descrição
CFormView::IsInitDlgCompleted	Usada para sincronização durante a inicialização.

Comentários

Uma exibição de formulário é essencialmente uma exibição que contém controles. Esses controles são dispostos com base em um recurso de modelo de caixa de diálogo. Use CFormView se quiser formulários em seu aplicativo. Essas exibições dão suporte à rolagem conforme necessário, usando a funcionalidade CScrollView.

Ao criar um aplicativo baseado em formulários, você pode basear a classe de exibição dele em CFormView, tornando-o um aplicativo baseado em formulários.

Você também pode inserir novos Tópicos de Formulário em aplicativos baseados em exibição de documento. Mesmo que seu aplicativo não tenha suporte inicialmente para formulários, o Visual C++ adicionará esse suporte quando você inserir um novo formulário.

O Assistente de Aplicativo do MFC e o comando Adicionar Classe são os métodos preferidos para criar aplicativos baseados em formulários. Se precisar criar um aplicativo baseado em formulários sem usar esses métodos, consulte Criar um aplicativo baseado em formulários.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CView

CScrollView

CFormView

Requisitos

Cabeçalhoafxext.h:

CFormView::CFormView

Constrói um objeto CFormView.

CFormView(LPCTSTR lpszTemplateName);
CFormView(UINT nIDTemplate);

Parâmetros

lpszTemplateName
Contém uma cadeia de caracteres terminada em NULL que é o nome de um recurso de modelo de caixa de diálogo.

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

Comentários

Ao criar um objeto de um tipo CFormView derivado, invoque um dos construtores para criar o objeto de exibição e identifique o recurso de caixa de diálogo no qual a exibição se baseia. Você pode identificar o recurso pelo nome (passe uma cadeia de caracteres como o argumento para o construtor) ou por sua ID (passe um inteiro sem sinal como o argumento).

A janela de exibição de formulário e os controles filho só são criados depois que CWnd::Create é chamado. CWnd::Create é chamado pela estrutura como parte do processo de criação e exibição do documento, que é controlado pelo modelo de documento.

Observação

Sua classe derivada deve fornecer um construtor próprio. No construtor, invoque o construtor, CFormView::CFormView, com o nome do recurso ou a ID como um argumento, conforme mostrado na visão geral da classe anterior.

Exemplo

// MyFormView.h

// CMyFormView form view

class CMyFormView : public CFormView
{
   DECLARE_DYNCREATE(CMyFormView)

protected:
   CMyFormView(); // protected constructor used by dynamic creation
   virtual ~CMyFormView();

public:
   enum
   {
      IDD = IDD_MYFORMVIEW
   };
#ifdef _DEBUG
   virtual void AssertValid() const;
#ifndef _WIN32_WCE
   virtual void Dump(CDumpContext &dc) const;
#endif
#endif

protected:
   virtual void DoDataExchange(CDataExchange *pDX); // DDX/DDV support

   DECLARE_MESSAGE_MAP()
public:
   afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);
};

 

// MyFormView.cpp

#include "MyFormView.h"

// CMyFormView

IMPLEMENT_DYNCREATE(CMyFormView, CFormView)

CMyFormView::CMyFormView()
    : CFormView(CMyFormView::IDD)
{
}

CFormView::IsInitDlgCompleted

Usado pelo MFC para garantir que a inicialização seja concluída antes de executar outras operações.

BOOL IsInitDlgCompleted() const;

Valor de Devolução

True se a função de inicialização dessa caixa de diálogo tiver sido concluída.

Confira também

Exemplo de MFC SNAPVW
Exemplo de MFC VIEWEX
Classe CScrollView
Gráfico da hierarquia
Classe CDialog