Compartilhar via


CArchive::m_pDocument

Defina a NULO por padrão, esse ponteiro para CDocument pode ser definido para algo que o usuário da instância de CArchive deseja.

CDocument* m_pDocument;

Comentários

Um uso comum de esse ponteiro é transmitir informações sobre o processo de serialização a todos os objetos que estão sendo serializados. Isso é conseguido inicializando o ponteiro com o documento ( CDocument- classe derivada) que está sendo serializada, de tal forma que os objetos no documento pode acessar o documento se necessário. Esse ponteiro também é usado por objetos de COleClientItem durante a serialização.

A estrutura define m_pDocument para o documento que está sendo serializado quando um usuário envia um comando de Arquivo de Abrir ou salvar. Se você serializa um objeto que contém e que insere o documento recipiente Object Linking and Embedding (OLE) para motivos diferentes de Arquivo Abrir ou salvar, você deve definir explicitamente m_pDocument. Por exemplo, você faria isso quando serializar um documento contêiner para a área de transferência.

Exemplo

CFile myFile(_T("My__test__file.dat"), 
   CFile::modeCreate | CFile::modeWrite);
CArchive ar(&myFile, CArchive::store);
CMyDocument mydoc;
ar.m_pDocument = &mydoc;

// Serialize the document to the archive. 
if (ar.m_pDocument != NULL)
   ar.m_pDocument->Serialize(ar);                    

Requisitos

Cabeçalho: afx.h

Consulte também

Referência

Classe CArchive

Gráfico da hierarquia

Classe CDocument

Classe COleClientItem