CDocument-Klasse

Artikel
06/10/2015

Stellt die grundlegende Funktionalität für benutzerdefinierte Dokumentklassen bereit.

class CDocument : public CCmdTarget

Mitglieder

Öffentliche Konstruktoren

Name	Description
CDocument::CDocument	Erstellt ein CDocument-Objekt.

Öffentliche Methoden

Name	Description
CDocument::AddView	Fügt eine Ansicht an das Dokument an.
CDocument::BeginReadChunks	Initialisiert Blockslesen.
CDocument::CanCloseFrame	Erweitertes überschreibbares; aufgerufen, bevor ein Rahmenfenster geschlossen wird, das dieses Dokument anzeigt.
CDocument::ClearChunkList	Löscht die Blocksliste.
CDocument::ClearPathName	Löscht den Pfad von dem Document-Objekt frei.
CDocument::DeleteContents	Aufgerufen, um Bereinigung des Dokuments auszuführen.
CDocument::FindChunk	Sucht nach einem Block mit dem angegebenen GUID.
CDocument::GetAdapter	Gibt einen Zeiger zurück, um aufzufüllen, IDocument-Schnittstelle zu implementieren.
CDocument::GetDocTemplate	Gibt einen Zeiger auf die Normal-Vorlage zurück, die den Typ des Dokuments beschreibt.
CDocument::GetFile	Gibt einen Zeiger auf den gewünschten CFile-Objekt zurück.
CDocument::GetFirstViewPosition	Gibt die Position der ersten in der Liste der Ansichten zurück; verwendet, um Iteration zu starten.
CDocument::GetNextView	Läuft durch die Liste Sichten durch, die dem Dokument zugeordnet werden.
CDocument::GetPathName	Gibt den Pfad der Datendatei des Dokuments zurück.
CDocument::GetThumbnail	Aufgerufen, um eine Miniaturansicht anzuzeigen, um vom Miniaturansichtsanbieter verwendet werden, Bitmap zu erstellen.
CDocument::GetTitle	Gibt den Namen des Dokuments zurück.
CDocument::InitializeSearchContent	Aufgerufen, um Sucheninhalt für Suchen-Handler zu initialisieren.
CDocument::IsModified	Gibt an, ob das Dokument geändert wurde, seit er zuletzt gespeichert wurde.
CDocument::IsSearchAndOrganizeHandler	Teilt mit, ob diese Instanz von CDocument-Objekt für Suche erstellt &. Handler organisiert wurde.
CDocument::LoadDocumentFromStream	Aufgerufen, um Dokumentendaten vom Stream verwenden.
CDocument::OnBeforeRichPreviewFontChanged	Aufgerufen, bevor Reich-Vorschauschriftart geändert wird.
CDocument::OnChangedViewList	Aufgerufen, nachdem eine Ansicht hinzugefügt ist oder aus dem Dokument entfernt.
CDocument::OnCloseDocument	Aufgerufen, um das Dokument zu schließen.
CDocument::OnCreatePreviewFrame	Aufgerufen vom Framework, wenn es Vorschauframe für Reich-Vorschau erstellen.
CDocument::OnDocumentEvent	Aufgerufen vom Framework als Reaktion auf ein Dokumentenereignis.
CDocument::OnDrawThumbnail	Überschreiben Sie diese Methode in einer abgeleiteten Klasse, um Inhalt der Miniaturansicht zu zeichnen.
CDocument::OnLoadDocumentFromStream	Aufgerufen vom Framework, wenn sie die Dokumentendaten vom Stream geladen werden muss.
CDocument::OnNewDocument	Aufgerufen, um ein neues Dokument zu erstellen.
CDocument::OnOpenDocument	Aufgerufen, um ein vorhandenes Dokument zu öffnen.
CDocument::OnPreviewHandlerQueryFocus	Beauftragt den Vorschauhandler, HWND aus dem Aufrufen der GetFocus-Funktion zurückzugeben.
CDocument::OnPreviewHandlerTranslateAccelerator	Beauftragt den Vorschauhandler, eine Tastatureingaben zu behandeln, die oben aus der Meldungsverteilschleife des Prozesses übergeben wird, in dem der Vorschauhandler ausgeführt wird.
CDocument::OnRichPreviewBackColorChanged	Aufgerufen, wenn Reich-Vorschauhintergrundfarbe geändert hat.
CDocument::OnRichPreviewFontChanged	Aufgerufen, wenn Reich-Vorschauschriftart geändert hat.
CDocument::OnRichPreviewSiteChanged	Aufgerufen, wenn Reich-Vorschausite geändert hat.
CDocument::OnRichPreviewTextColorChanged	Aufgerufen, wenn Reich-Vorschautextfarbe geändert hat.
CDocument::OnSaveDocument	Aufgerufen, um das Dokument auf dem Datenträger zu speichern.
CDocument::OnUnloadHandler	Aufgerufen vom Framework, wenn der Vorschauhandler entladen wird.
CDocument::PreCloseFrame	Aufgerufen vor dem Rahmenfenster wird geschlossen.
CDocument::ReadNextChunkValue	Liest folgenden Blockswert.
CDocument::ReleaseFile	Gibt eine Datei auschecken, um sie bereitzustellen für andere Anwendungen.
CDocument::RemoveChunk	Entfernt einen Block mit angegebenem GUID.
CDocument::RemoveView	Trennt eine Ansicht im Dokument.
CDocument::ReportSaveLoadException	Erweitertes schreibbares; aufgerufen, wenn ein offenes oder ein Speichervorgang aufgrund einer Ausnahme abgeschlossen werden können.
CDocument::SaveModified	Erweitertes schreibbares; aufgerufen, um den Benutzer zu fragen, ob das Dokument gespeichert werden soll.
CDocument::SetChunkValue	Legt einen Blockswert fest.
CDocument::SetModifiedFlag	Legt ein Flag fest, dass Sie das Dokument geändert haben, seit der zuletzt gespeichert wurde.
CDocument::SetPathName	Legt den Pfad der Datendatei ab, die durch das Dokument verwendet wird.
CDocument::SetTitle	Legt den Namen des Dokuments fest.
CDocument::UpdateAllViews	Benachrichtigt alle Ansichten, die Dokument geändert wurde.

Geschützte Methoden

Name	Description
CDocument::OnFileSendMail	Sendet eine E-Mail-Nachricht mit dem angefügten Dokument.
CDocument::OnUpdateFileSendMail	Ermöglicht den sendens-E-Mail-Befehl, wenn E-Mail-Unterstützung vorhanden ist.

Öffentliche Datenmember

Name	Description
CDocument::m_bGetThumbnailMode	Gibt an, dass CDocument-Objekt durch dllhost für Miniaturansichten erstellt wurde. sollte dieses in dem CView::OnDraw.
CDocument::m_bPreviewHandlerMode	Gibt an, dass CDocument-Objekt durch prevhost für Rich Preview erstellt wurde. sollte dieses in dem CView::OnDraw.
CDocument::m_bSearchMode	Gibt an, dass CDocument-Objekt dem Indexer oder anderer Suchen-Anwendung erstellt wurde.
CDocument::m_clrRichPreviewBackColor	Gibt Hintergrundfarbe des Reich-Vorschaufensters an. Diese Farbe wird von Host festgelegt.
CDocument::m_clrRichPreviewTextColor	Gibt Vordergrundfarbe des Reich-Vorschaufensters an. Diese Farbe wird von Host festgelegt.
CDocument::m_lfRichPreviewFont	Gibt Textschriftart für Reich-Vorschaufenster an. Diese Schriftartinformationen werden vom Host festgelegt.

Hinweise

Ein Dokument stellt die Gruppierung von Daten dar, die der Benutzer in der Regel mit dem geöffneten Befehl der Datei geöffnet und mit dem Datei-Abwehrbefehl gespeichert werden.

CDocument Standardvorgänge unterstützt das Erstellen eines Dokuments, das Laden und Speichern es. Das Framework bearbeitet Dokumente mithilfe der Schnittstelle, die von CDocument definiert ist.

Eine Anwendung kann mehr als einen Typ Dokument unterstützen; beispielsweise unterstützt möglicherweise eine Anwendung Arbeitsblätter und Textdokumente. Jeder Typ Dokument verfügt über eine zugeordnete Normal-Vorlage; die Normal-Vorlage gibt an, welche Ressourcen (beispielsweise, Menü, Symbol oder Zugriffstastentabelle) für diesen Typ des Dokuments verwendet werden. Jedes Dokument enthält einen Zeiger auf dem zugeordneten CDocTemplate-Objekt.

Benutzer interagieren mit einem Dokument unter CView-Objekte, die zugeordnet. Eine Ansicht rendert ein Bild des Dokuments in einem Rahmenfenster und interpretiert Benutzereingaben als Vorgänge im Dokument. Ein Dokument kann mehrere Ansichten verfügen, die zugeordnet. Wenn der Benutzer ein Fenster auf einem Dokument öffnet, erstellt das Framework eine Ansicht und fügt sie dem Dokument an. Die Normal-Vorlage gibt an, welcher Ansichts- und Rahmenfenster verwendet werden, um jeden Typ Dokument anzuzeigen.

Dokumente sind Teil des Standardbefehlsroutings des Frameworks empfangen und infolgedessen Befehle von den Standardbenutzeroberflächenkomponenten (wie dem Datei-Abwehrmenüelement). Ein Dokument empfängt die Befehle, die durch die aktive Ansicht weitergeleitet werden. Wenn das Dokument keinen angegebenen Befehl verarbeitet, wird es den Befehl an die Normal-Vorlage weiter, die ihn verwaltet.

Wenn die Daten eines Dokuments geändert werden, muss jede seiner Ansichten diese Änderungen widerspiegeln. CDocument stellt die UpdateAllViews-Memberfunktion bereit, sodass Sie die Ansichten solche Änderungen benachrichtigen, sodass die Ansichten nach Bedarf selbst neu zeichnet. Das Framework benötigt auch den Benutzer auf, eine geänderte Datei zu speichern, bevor sie geschlossen wird.

Um Dokumente in einer typischen Anwendung implementieren, müssen Sie wie folgt vorgehen:

Leiten Sie eine Klasse von CDocument für jeden Typ Dokument.
Fügen Sie Membervariablen hinzu, um die Daten jedes Dokuments zu speichern.
Implementieren Sie Memberfunktionen für das Lesen und Ändern der Daten des Dokuments. Die Ansichten des Dokuments sind die wichtigsten Benutzer dieser Memberfunktionen.
Überschreiben Sie die CObject::Serialize-Memberfunktion der Dokumentklasse, um die Daten des Dokuments nach und von einem Datenträger zu schreiben und zu lesen.

CDocument unterstützt das Senden des Dokuments über E-Mail, wenn E-Mail-Unterstützung (MAPI) vorhanden ist. Siehe die Artikel MAPI und MAPI-Unterstützung in MFC.

Weitere Informationen zu CDocument, finden Sie unter Serialisierung, Dokument-/Ansichtsarchitektur-Themen und Dokument/Ansichts-Erstellung.