Estrutura CCreateContext

Artigo
08/25/2010

A estrutura usa o CCreateContext estrutura quando cria o quadro de janelas e modos de exibição associados a um documento.

struct CCreateContext

Comentários

CCreateContext é uma estrutura e não tem uma classe base.

Ao criar uma janela, os valores dessa estrutura fornecem informações usadas para conectar os componentes que compõem um documento e o modo de exibição de seus dados.Você só precisará usar CCreateContext Se você está substituindo partes do processo de criação.

A CCreateContext estrutura contém ponteiros para o documento, a janela do quadro, o modo de exibição e o modelo de documento. Ele também contém um ponteiro para um CRuntimeClass que identifica o tipo de exibição para criar. As informações de classe de time de execução e o ponteiro corrente do documento são usadas para criar um novo modo de exibição dinâmica.A tabela a seguir sugere como e quando cada CCreateContext membro pode ser usado:

Membro	Para que ela serve
m_pNewViewClass	CRuntimeClass do novo modo de exibição para criar.
m_pCurrentDoc	O documento existente a ser associado com o novo modo de exibição.
m_pNewDocTemplate	O modelo de documento associado a criação de uma nova janela de quadro MDI.
m_pLastView	O modo de exibição original na qual exibições adicionais são modeladas, sistema autônomo na criação de modos de exibição de uma janela do divisor ou a criação de um segundo modo de exibição em um documento.
m_pCurrentFrame	A janela do quadro no qual janelas de quadro adicional são modeladas, sistema autônomo na criação de uma segunda janela do quadro em um documento.

Quando um modelo de documento cria um documento e seus componentes associados, ele valida as informações armazenadas no CCreateContext estrutura. Por exemplo, um modo de exibição não deve ser criado para um documento inexistente.

Observação:
Todos os ponteiros em CCreateContext são opcionais e podem ser NULO se não for especificado ou desconhecido.

CCreateContextusados pelas funções membro listadas em "Consulte também". Consulte as descrições dessas funções para obter informações específicas, se você pretende substituí-los.

Aqui estão algumas diretrizes Geral:

Quando passados sistema autônomo um argumento para a criar da janela, sistema autônomo em CWnd::Create, CFrameWnd::Create, e CFrameWnd::LoadFrame, o contexto de criar Especifica o que a nova janela deve ser conectada ao. Para a maioria das janelas, a estrutura inteira é opcional e NULO ponteiro pode ser passado.
Para funções de membro substituíveis, sistema autônomo CFrameWnd::OnCreateClient, o CCreateContext argumento é opcional.
Para funções de membro envolvidas na exibição criação, você deve fornecer informações suficientes para criar o modo de exibição.Por exemplo, para o primeiro modo de exibição em uma janela separadora, você deve fornecer as informações de classe do modo de exibição e o documento corrente.

Em geral, se você usar os padrões de estrutura, você pode ignorar CCreateContext. Se você tentar modificações mais avançadas, o código de fonte da biblioteca Microsoft Foundation classe ou programas de exemplo, sistema autônomo VIEWEX, irá guiá-lo.Se você esquecer um parâmetro obrigatório, uma declaração de estrutura informará você esqueceu.

Para obter mais informações sobre o CCreateContext, consulte o exemplo do MFC VIEWEX.