Estrutura CCreateContext
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.
.gif "Observação") 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.
Requisitos
Cabeçalho: afxext.h