Classe CDocument

Artigo
06/10/2015

Fornece a funcionalidade básica para classes definidas pelo usuário do documento.

class CDocument : public CCmdTarget

Membros

Construtores public

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

Métodos públicos

Nome	Descrição
CDocument::AddView	Anexar uma exibição para o documento.
CDocument::BeginReadChunks	Inicializa a leitura da parte.
CDocument::CanCloseFrame	Overridable avançado; chamado antes de fechar uma janela de quadro que exibe este documento.
CDocument::ClearChunkList	Limpa a lista de parte.
CDocument::ClearPathName	Limpa o caminho de objeto de documento.
CDocument::DeleteContents	Chamado para executar limpeza do documento.
CDocument::FindChunk	Procurando uma parte com um GUID especificado.
CDocument::GetAdapter	Retorna um ponteiro para object implementando a interface de IDocument .
CDocument::GetDocTemplate	Retorna um ponteiro para o modelo de documento que descreve o tipo do documento.
CDocument::GetFile	Retorna um ponteiro para o objeto desejado de CFile .
CDocument::GetFirstViewPosition	Retorna a posição da primeira na lista de exibição; usado para iniciar a iteração.
CDocument::GetNextView	Itera através da lista de visualizações associadas com o documento.
CDocument::GetPathName	Retorna o caminho do arquivo de dados do documento.
CDocument::GetThumbnail	Chamado para criar um bitmap a ser usado pelo provedor em miniatura para exibir a miniatura.
CDocument::GetTitle	Retorna o título do documento.
CDocument::InitializeSearchContent	Chamado para inicializar o conteúdo de pesquisa para o manipulador de Pesquisa.
CDocument::IsModified	Indica se o documento foi alterado desde que foi o exceto o último.
CDocument::IsSearchAndOrganizeHandler	Informa se essa instância do objeto de CDocument foi criada para Pesquisar e organizar o manipulador.
CDocument::LoadDocumentFromStream	Chamado para carregar dados de documento de fluxo.
CDocument::OnBeforeRichPreviewFontChanged	Chamado antes da fonte de visualização rico é alterado.
CDocument::OnChangedViewList	Chamado depois que uma visualização é adicionada a ou removido do documento.
CDocument::OnCloseDocument	Chamado para fechar o documento.
CDocument::OnCreatePreviewFrame	Chamado pela estrutura quando precisar criar um quadro de visualização para a visualização rico.
CDocument::OnDocumentEvent	Chamado pela estrutura em resposta a um evento do documento.
CDocument::OnDrawThumbnail	Substitua esse método em uma classe derivada para desenhar o conteúdo em miniatura.
CDocument::OnLoadDocumentFromStream	Chamado pela estrutura quando precisar carregar os dados de documento de fluxo.
CDocument::OnNewDocument	Chamado para criar um novo documento.
CDocument::OnOpenDocument	Chamado para abrir um documento existente.
CDocument::OnPreviewHandlerQueryFocus	Direciona o manipulador de visualização para retornar o HWND de chamar a função de GetFocus.
CDocument::OnPreviewHandlerTranslateAccelerator	Direciona o manipulador de visualização para manipular um pressionamento de tecla passada acima de mensagem bomba do processo no qual o manipulador de visualização está sendo executado.
CDocument::OnRichPreviewBackColorChanged	Chamado quando a cor do plano de fundo de visualização rico alterar.
CDocument::OnRichPreviewFontChanged	Chamado quando a fonte de visualização rico alterar.
CDocument::OnRichPreviewSiteChanged	Chamado quando o site de visualização rico alterar.
CDocument::OnRichPreviewTextColorChanged	Chamado quando a cor do texto rico de visualização alterado.
CDocument::OnSaveDocument	Chamado para salvar o documento no disco.
CDocument::OnUnloadHandler	Chamado pela estrutura quando o manipulador de visualização é descarregado.
CDocument::PreCloseFrame	Chamado antes da janela de quadro chave é fechado.
CDocument::ReadNextChunkValue	Valor próximo à parte de leitura.
CDocument::ReleaseFile	Libera um arquivo para torná-lo disponível para uso por outros aplicativos.
CDocument::RemoveChunk	Remove uma parte com um GUID especificado.
CDocument::RemoveView	Dispara uma exibição de documentos.
CDocument::ReportSaveLoadException	Overridable avançado; chamado quando uma operação aberta ou de salvamento não pode ser concluída por causa de uma exceção.
CDocument::SaveModified	Overridable avançado; chamado para perguntar ao usuário se o documento deve ser salvo.
CDocument::SetChunkValue	Define um valor da parte.
CDocument::SetModifiedFlag	Define um sinalizador indicando que você alterou o documento desde que foi o exceto o último.
CDocument::SetPathName	Defina o caminho do arquivo de dados usado pelo documento.
CDocument::SetTitle	Define o título do documento.
CDocument::UpdateAllViews	Notifica todas as exibições do documento foi alterado.

Métodos protegidos

Nome	Descrição
CDocument::OnFileSendMail	Envia uma mensagem de email com o documento anexado.
CDocument::OnUpdateFileSendMail	Permite que o comando de enviar e-mail se o suporte de e-mail estiver presente.

Membros públicos de dados

Nome	Descrição
CDocument::m_bGetThumbnailMode	Especifica que o objeto de CDocument foi criado pelo dllhost para as miniaturas. Deve ser CView::OnDrawfazer o check-in.
CDocument::m_bPreviewHandlerMode	Especifica que o objeto de CDocument foi criado pelo prevhost para Rich Preview. Deve ser CView::OnDrawfazer o check-in.
CDocument::m_bSearchMode	Especifica que o objeto de CDocument foi criado pelo indexador ou por outro aplicativo de pesquisa.
CDocument::m_clrRichPreviewBackColor	Especifica a cor do plano de fundo da janela de visualização rico. Esta cor é definida pelo host.
CDocument::m_clrRichPreviewTextColor	Especifica primeiro plano a cor da janela de visualização rico. Esta cor é definida pelo host.
CDocument::m_lfRichPreviewFont	Especifica a fonte do texto para a janela de visualização rico. Essa informação de fonte é definida pelo host.

Comentários

Um documento representa a unidade de dados que o usuário normalmente abre com o comando de Abrir Arquivo e salva com o comando de salvamento de Arquivo.

CDocument suporta operações padrões como a criação de um documento, carregá-lo, e salvá-los. a estrutura manipula documentos usando a interface definida por CDocument.

Um aplicativo pode suportar mais de um tipo de documento; por exemplo, um aplicativo pode oferecer planilhas e documentos de texto. Cada tipo de documento tem um modelo associado do documento; o modelo do documento especifica quais recursos (por exemplo, menu, ícone, ou tabela de aceleração) são usados para esse tipo de documento. Cada documento contém um ponteiro para seu respectivo objeto de CDocTemplate .

Os usuários interagem com um documento através de objetos de CView associados com ele. Uma exibição processa uma imagem do documento em uma janela do quadro e interpreta a entrada do usuário como operações no documento. Um documento pode ter múltiplas visualizações associadas com ele. Quando o usuário abre uma janela em um documento, a estrutura criar um modo de exibição e anexá-la ao documento. O modelo do documento especifica que tipo de janela de exibição e do quadro é usado para exibir cada tipo de documento.

Documentos são parte de roteamento padrão de comando de estrutura e recebem portanto comandos de componentes padrão da interface do usuário (como o item de menu de salvamento de Arquivo). Um documento recebe os comandos encaminhados pela exibição ativo. Se o documento não trata um determinado comando, encaminha o comando para o modelo de documento que gerencia o.

Quando os dados de um documento são alterados, cada uma de suas exibições deve refletir as alterações. CDocument fornece a função de membro de UpdateAllViews para que você notificar as exibições de essas alterações, portanto visualizações podem repintar-se conforme necessário. A estrutura também solicita ao usuário para salvar um arquivo alterado antes de feche-o.

Para implementar documentos em um aplicativo típico, você deve fazer o seguinte:

Derive uma classe de CDocument para cada tipo de documento.
Adicione variáveis de membro para armazenar os dados de cada documento.
Implementar funções de membro para ler e modificar os dados do documento. As exibições de documentos são os usuários mais importantes de essas funções de membro.
Substitua a função de membro de CObject::Serialize em sua classe de documento para gravar e ler os dados do documento para o disco.

CDocument suporta seu documento enviar por email se o suporte de email (MAPI) está presente. Consulte os artigos MAPI e Suporte de MAPI no MFC.

Para obter mais informações sobre CDocument, consulte serialização, Arquitetura de tópicos do documento/exibição, e Criação de documento/exibição.