Freigeben über


CDocument-Klasse

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.

Vererbungshierarchie

CObject

CCmdTarget

CDocument

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CCmdTarget-Klasse

Hierarchiediagramm

CCmdTarget-Klasse

CView-Klasse

CDocTemplate-Klasse

Konzepte

MFC überprüft MDIDOCVW

MFC-Beispiel SNAPVW

MFC-Beispiel-NPP