Classe CDocument

Articolo
06/10/2015

Fornisce la funzionalità di base per le classi definite dall'utente del documento.

class CDocument : public CCmdTarget

Membri

Costruttori pubblici

Nome	Descrizione
CDocument::CDocument	Costruisce un oggetto CDocument.

Metodi pubblici

Nome	Descrizione
CDocument::AddView	Aggiunge una visualizzazione al documento.
CDocument::BeginReadChunks	Inizializza la lettura del blocco.
CDocument::CanCloseFrame	Sottoponibile a override avanzato, chiamata prima di chiudere una finestra cornice che visualizza questo documento.
CDocument::ClearChunkList	Cancella l'elenco di blocco.
CDocument::ClearPathName	Rimuove il percorso dell'oggetto del documento.
CDocument::DeleteContents	Chiamato per eseguire pulizia di documento.
CDocument::FindChunk	Cerca un blocco con il GUID specificato.
CDocument::GetAdapter	Restituisce un puntatore a un oggetto implementando l'interfaccia IDocument.
CDocument::GetDocTemplate	Restituisce un puntatore al modello di documento che descrive il tipo di documento.
CDocument::GetFile	Restituisce un puntatore all'oggetto desiderato CFile.
CDocument::GetFirstViewPosition	Restituisce la posizione del primo l'elenco delle visualizzazioni, utilizzato per avviare l'iterazione.
CDocument::GetNextView	Scorre l'elenco delle visualizzazioni associate al documento.
CDocument::GetPathName	Restituisce il percorso del file di dati del documento.
CDocument::GetThumbnail	Chiamato per creare una bitmap da utilizzare dal provider di anteprima per visualizzare l'anteprima.
CDocument::GetTitle	Restituisce il titolo del documento.
CDocument::InitializeSearchContent	Chiamato per inizializzare il contenuto di ricerca per il gestore trovato.
CDocument::IsModified	Indica se il documento è stato modificato da quando è stato salvato per ultima.
CDocument::IsSearchAndOrganizeHandler	Indica se questa istanza dell'oggetto CDocument è stata creata per la ricerca e organizzare il gestore.
CDocument::LoadDocumentFromStream	Chiamato per caricare i dati del documento il flusso.
CDocument::OnBeforeRichPreviewFontChanged	Prima di completezza di visualizzare in anteprima il tipo chiamata viene modificata.
CDocument::OnChangedViewList	Chiamato dopo che una visualizzazione viene aggiunta o rimossa dal documento.
CDocument::OnCloseDocument	Chiamato per chiudere il documento.
CDocument::OnCreatePreviewFrame	Chiamato dal framework quando deve creare un frame di anteprima per l'anteprima complesso.
CDocument::OnDocumentEvent	Chiamato dal framework in risposta a un evento del documento.
CDocument::OnDrawThumbnail	Eseguire l'override di questo metodo in una classe derivata per disegnare il contenuto di anteprima.
CDocument::OnLoadDocumentFromStream	Chiamato dal framework quando deve caricare i dati del documento il flusso.
CDocument::OnNewDocument	Chiamato per creare un nuovo documento.
CDocument::OnOpenDocument	Chiamato per aprire un documento esistente.
CDocument::OnPreviewHandlerQueryFocus	Esegue il gestore di anteprima per restituire HWND da chiamare la funzione di GetFocus.
CDocument::OnPreviewHandlerTranslateAccelerator	Esegue il gestore di anteprima per gestire una sequenza di tasti lasciata nel message pump del processo in cui il gestore eventi preview è in esecuzione.
CDocument::OnRichPreviewBackColorChanged	Quando completezza visualizzare in anteprima il colore di sfondo chiamato è stato modificato.
CDocument::OnRichPreviewFontChanged	Quando completezza visualizzare in anteprima il tipo chiamata ha modificato.
CDocument::OnRichPreviewSiteChanged	Chiamato quando il sito di anteprima complesso ha modificato.
CDocument::OnRichPreviewTextColorChanged	Quando completezza visualizzare in anteprima il colore del testo definito è stato modificato.
CDocument::OnSaveDocument	Chiamato per salvare il documento su disco.
CDocument::OnUnloadHandler	Chiamato dal framework quando il gestore di anteprima il download.
CDocument::PreCloseFrame	Chiamata prima della finestra cornice viene chiusa.
CDocument::ReadNextChunkValue	Legge il valore del blocco.
CDocument::ReleaseFile	Genera un file per renderlo disponibile per l'utilizzo in altre applicazioni.
CDocument::RemoveChunk	Rimuove un blocco con il GUID specificato.
CDocument::RemoveView	Rimuove una visualizzazione del documento.
CDocument::ReportSaveLoadException	Sottoponibile a override avanzato, chiamato quando un'operazione di salvataggio o aperta non può essere completata a causa di un'eccezione.
CDocument::SaveModified	Sottoponibile a override avanzato, chiamato per chiedere all'utente se il documento deve essere salvato.
CDocument::SetChunkValue	Imposta un valore di blocco.
CDocument::SetModifiedFlag	Impostare un flag che indica che è stato modificato il documento da quando è stato salvato per ultima.
CDocument::SetPathName	Imposta il percorso del file di dati utilizzato dal documento.
CDocument::SetTitle	Imposta il titolo del documento.
CDocument::UpdateAllViews	Notifica tutte le visualizzazioni che il documento è stato modificato.

Metodi protetti

Nome	Descrizione
CDocument::OnFileSendMail	Invia un messaggio di posta elettronica con il documento associato.
CDocument::OnUpdateFileSendMail	Abilita il comando di posta elettronica di inviare se il supporto di posta elettronica è presente.

Membri dati pubblici

Nome	Descrizione
CDocument::m_bGetThumbnailMode	Specifica che l'oggetto CDocument è stato creato da dllhost per le anteprime. Deve essere CView::OnDrawcontrollato.
CDocument::m_bPreviewHandlerMode	Specifica che l'oggetto CDocument è stato creato da prevhost per Rich Preview. Deve essere CView::OnDrawcontrollato.
CDocument::m_bSearchMode	Specifica che l'oggetto CDocument è stato creato dall'indicizzatore o da un'altra applicazione di ricerca.
CDocument::m_clrRichPreviewBackColor	Specifica il colore di sfondo della finestra di anteprima dettagliata. Il colore viene impostato dall'host.
CDocument::m_clrRichPreviewTextColor	Specifica il colore di primo piano della finestra di anteprima dettagliata. Il colore viene impostato dall'host.
CDocument::m_lfRichPreviewFont	Specifica il tipo di carattere del testo per la finestra di anteprima dettagliata. Queste informazioni di carattere sono impostate dall'host.

Note

Un documento rappresenta l'unità di dati che l'utente in genere aperto con il comando aperto il file e salvarlo con il comando salva il file.

CDocument supporta le operazioni standard come creare un documento, il caricamento e salvarla. Il framework modifica di documenti tramite l'interfaccia definita da CDocument.

Un'applicazione può supportare più di un tipo di documento; ad esempio, un'applicazione potrebbe supportare sia i fogli di calcolo che i documenti di testo. Ogni tipo di documento include un modello di documento collegato; il modello di documento specifica di risorse, ad esempio menu, icona, o tabella dei tasti di scelta rapida) vengono utilizzati per tale tipo di documento. Ogni documento contiene un puntatore al relativo oggetto collegato CDocTemplate.

Gli utenti interagiscono con un documento tramite oggetti CView associati. Una visualizzazione esegue il rendering di un'immagine di documento in una finestra cornice e interpreta l'input come operazioni nel documento. Un documento può disporre di più visualizzazioni associate. Quando l'utente apre una finestra in un documento, il framework crea una visualizzazione e allegarlo al documento. Il modello di documento specifica il tipo di visualizzazione e della finestra cornice viene utilizzata per visualizzare ogni tipo di documento.

I documenti fa parte del routing dei comandi standard del framework e controlli di conseguenza di ricezione da componenti standard dell'interfaccia utente (ad esempio una voce di menu di salvataggio file). Un documento riceve i controlli inoltrati tramite la visualizzazione attiva. Se il documento non gestisce un comando specificato, inoltra il comando al modello di documento che lo gestisce.

Quando i dati di un documento vengono modificati, ognuna delle visualizzazioni deve riflettere le modifiche. CDocument fornisce la funzione membro UpdateAllViews per notificare alle visualizzazioni di tali modifiche, pertanto le visualizzazioni possono essere aggiornata automaticamente in base alle esigenze. Il framework sono richiede all'utente di salvare un file modificato prima di chiuderlo.

Per distribuire documenti in un'applicazione tipica, è necessario effettuare quanto segue:

Derivare la classe da CDocument per ogni tipo di documento.
Aggiungere le variabili membro per archiviare i dati di ogni documento.
Implementare le funzioni membro per la lettura e la modifica dei dati del documento. Le visualizzazioni del documento sono gli utenti più importanti di queste funzioni membro.
Eseguire l'override della funzione membro CObject::Serialize nella classe del documento per scrivere e leggere i dati del documento da e su disco.

CDocument supporta inviare il documento tramite posta elettronica se il supporto di posta elettronica (MAPI) è presente. Vedere gli articoli MAPI e Supporto MAPI in MFC.

Per ulteriori informazioni su CDocument, vedere serializzazione, Argomenti con l'architettura documentoe Creazione documento/visualizzazione.