CDocTemplate-Klasse

Eine abstrakte Basisklasse, die die grundlegende Funktionalität für Dokumentvorlagen definiert.

Syntax

class CDocTemplate : public CCmdTarget

Member

Geschützte Konstruktoren

Name Beschreibung
CDocTemplate:: CDocTemplate Erstellt ein CDocTemplate-Objekt.

Öffentliche Methoden

name Beschreibung
CDocTemplate:: adddocument Fügt einer Vorlage ein Dokument hinzu.
CDocTemplate:: closealldocuments Schließt alle dieser Vorlage zugeordneten Dokumente.
CDocTemplate:: kreatenewdocument Erstellt ein neues Dokument.
CDocTemplate:: kreatenewframe Erstellt ein neues Rahmen Fenster, das ein Dokument und eine Ansicht enthält.
CDocTemplate:: kreateoleframe Erstellt ein OLE-fähiges Rahmen Fenster.
CDocTemplate:: "kreatepreviewframe" Erstellt einen für Rich Preview verwendeten untergeordneten Frame.
CDocTemplate:: getdocstring Ruft eine Zeichenfolge ab, die dem Dokumenttyp zugeordnet ist.
CDocTemplate:: getfirstdocposition Ruft die Position des ersten Dokuments ab, das dieser Vorlage zugeordnet ist.
CDocTemplate:: getnextdoc Ruft ein Dokument und die Position des nächsten ab.
CDocTemplate:: initialupdateframe Initialisiert das Rahmen Fenster und macht es optional sichtbar.
CDocTemplate:: LoadTemplate Lädt die Ressourcen für eine angegebene CDocTemplate oder eine abgeleitete Klasse.
CDocTemplate:: matchdoctype Bestimmt den Grad des Konfidenz Werts in der Übereinstimmung zwischen einem Dokumenttyp und dieser Vorlage.
CDocTemplate:: OpenDocumentFile Öffnet eine durch einen Pfadnamen angegebene Datei.
CDocTemplate:: RemoveDocument Entfernt ein Dokument aus einer Vorlage.
CDocTemplate:: saveallmodified Speichert alle dieser Vorlage zugeordneten Dokumente, die geändert wurden.
CDocTemplate:: setcontainerinfo Bestimmt die Ressourcen für OLE-Container, wenn ein direktes OLE-Element bearbeitet wird.
CDocTemplate:: setdefaulttitle Zeigt den Standard Titel in der Titelleiste des Dokument Fensters an.
CDocTemplate:: setpreviewinfo Einrichtung des Out-of-Process-Vorschau Handlers.
CDocTemplate:: setserverinfo Bestimmt die Ressourcen und Klassen, wenn das Server Dokument direkt eingebettet oder bearbeitet wird.

Bemerkungen

In der Regel erstellen Sie eine oder mehrere Dokumentvorlagen in der Implementierung der- InitInstance Funktion Ihrer Anwendung. Eine Dokument Vorlage definiert die Beziehungen zwischen drei Typen von Klassen:

  • Eine Dokument Klasse, von der abgeleitet wird CDocument .

  • Eine Ansichts Klasse, die Daten aus der oben aufgeführten Dokument Klasse anzeigt. Sie können diese Klasse von CView , CScrollView , oder ableiten CFormView CEditView . (Sie können auch CEditView direkt verwenden.)

  • Eine Frame Fenster Klasse, die die Ansicht enthält. Bei einer Anwendung mit einer einzelnen Dokument Schnittstelle (SDI) leiten Sie diese Klasse von ab CFrameWnd . Bei einer MDI-Anwendung (Multiple Document Interface) leiten Sie diese Klasse von ab CMDIChildWnd . Wenn Sie das Verhalten des Rahmen Fensters nicht anpassen müssen, können Sie CFrameWnd oder direkt verwenden, CMDIChildWnd ohne Ihre eigene Klasse zu ableiten.

Die Anwendung verfügt über eine Dokument Vorlage für jeden unterstützten Dokumenttyp. Wenn Ihre Anwendung z. b. sowohl Tabellen-als auch Textdokumente unterstützt, verfügt die Anwendung über zwei Dokumentvorlagen Objekte. Jede Dokument Vorlage ist für das Erstellen und Verwalten aller Dokumente seines Typs zuständig.

In der Dokument Vorlage werden Zeiger auf die CRuntimeClass -Objekte für die Dokument-, Ansichts-und Rahmen Fenster Klassen gespeichert. Diese CRuntimeClass Objekte werden beim Erstellen einer Dokument Vorlage angegeben.

Die Dokument Vorlage enthält die ID der Ressourcen, die mit dem Dokumenttyp verwendet werden (z. b. Menü-, Symbol-oder Zugriffstasten-Tabellen Ressourcen). Die Dokument Vorlage enthält auch Zeichen folgen, die zusätzliche Informationen über den Dokumenttyp enthalten. Hierzu gehören der Name des Dokument Typs (z. b. "Arbeitsblatt") und die Dateierweiterung (z. b. ". xls"). Optional können Sie auch andere Zeichen folgen enthalten, die von der Benutzeroberfläche der Anwendung, vom Windows-Datei-Manager und von der Unterstützung für das Verknüpfen und Einbetten von Objekten verwendet werden.

Wenn es sich bei Ihrer Anwendung um einen OLE-Container und/oder-Server handelt, wird in der Dokument Vorlage auch die ID des Menüs definiert, das während der direkten Aktivierung verwendet wird. Wenn es sich bei Ihrer Anwendung um einen OLE-Server handelt, definiert die Dokument Vorlage die ID der Symbolleiste und des Menüs, die während der direkten Aktivierung verwendet werden. Sie geben diese zusätzlichen OLE-Ressourcen an, indem Sie SetContainerInfo und aufrufen SetServerInfo .

Da CDocTemplate eine abstrakte Klasse ist, können Sie die-Klasse nicht direkt verwenden. Eine typische-Anwendung verwendet eine der zwei CDocTemplate abgeleiteten Klassen, die vom Microsoft Foundation Class-Bibliothek bereitgestellt werden: CSingleDocTemplate , das SDI implementiert, und CMultiDocTemplate , das MDI implementiert. Weitere Informationen zur Verwendung von Dokumentvorlagen finden Sie in diesen Klassen.

Wenn Ihre Anwendung ein Benutzeroberflächen Paradigma erfordert, das sich grundlegend von SDI oder MDI unterscheidet, können Sie eine eigene Klasse von ableiten CDocTemplate .

Weitere Informationen zu CDocTemplate finden Sie unter Dokumentvorlagen und der Erstellungs Vorgang für Dokumente und Ansichten.

Vererbungshierarchie

CObject

CCmdTarget

CDocTemplate

Anforderungen

Header: afxwin.h

CDocTemplate:: adddocument

Verwenden Sie diese Funktion, um ein Dokument zu einer Vorlage hinzuzufügen.

virtual void AddDocument(CDocument* pDoc);

Parameter

pDoc
Ein Zeiger auf das hinzu zufügende Dokument.

Bemerkungen

Die abgeleiteten Klassen CMultiDocTemplate und CSingleDocTemplate überschreiben diese Funktion. Wenn Sie Ihre eigene Dokumentvorlagen Klasse von ableiten CDocTemplate , muss die abgeleitete Klasse diese Funktion überschreiben.

CDocTemplate:: CDocTemplate

Erstellt ein CDocTemplate-Objekt.

CDocTemplate (
    UINT nIDResource,
    CRuntimeClass* pDocClass,
    CRuntimeClass* pFrameClass,
    CRuntimeClass* pViewClass);

Parameter

nidresource
Gibt die ID der Ressourcen an, die mit dem Dokumenttyp verwendet werden. Dies kann Menü, Symbol, Zugriffstasten Tabelle und Zeichen folgen Ressourcen umfassen.

Die Zeichen folgen Ressource besteht aus bis zu sieben Teil Zeichenfolgen, die durch das Zeichen ' \n ' getrennt sind (das Zeichen ' \n ' wird als Platzhalter benötigt, wenn keine Teil Zeichenfolge eingeschlossen wird. nachfolgende ' \n '-Zeichen sind jedoch nicht erforderlich); Diese Teil Zeichenfolgen beschreiben den Dokumenttyp. Weitere Informationen zu den Teil Zeichenfolgen finden Sie unter getdocstring. Diese Zeichen folgen Ressource befindet sich in der Ressourcen Datei der Anwendung. Zum Beispiel:

// MYCALC.RC
STRINGTABLE PRELOAD DISCARDABLE
BEGIN
  IDR_SHEETTYPE "\nSheet\nWorksheet\nWorksheets (*.myc)\n.myc\n MyCalcSheet\nMyCalc Worksheet"
END

Beachten Sie, dass die Zeichenfolge mit dem Zeichen "\n" beginnt. Dies liegt daran, dass die erste Teil Zeichenfolge nicht für MDI-Anwendungen verwendet wird und daher nicht eingeschlossen ist. Sie können diese Zeichenfolge mit dem Zeichen folgen-Editor bearbeiten. die gesamte Zeichenfolge wird als einzelner Eintrag im Zeichen folgen-Editor angezeigt, nicht als sieben separate Einträge.

pdocclass
Verweist auf das- CRuntimeClass Objekt der Document-Klasse. Diese Klasse ist eine CDocument von abgeleitete Klasse, die Sie zur Darstellung Ihrer Dokumente definieren.

pframeclass
Verweist auf das- CRuntimeClass Objekt der Rahmen Fenster Klasse. Diese Klasse kann eine von CFrameWnd abgeleitete Klasse sein, oder Sie kann CFrameWnd selbst sein, wenn Sie das Standardverhalten für das Hauptrahmen Fenster wünschen.

pviewclass
Verweist auf das- CRuntimeClass Objekt der Ansichts Klasse. Diese Klasse ist eine CView von abgeleitete Klasse, die Sie definieren, um Ihre Dokumente anzuzeigen.

Bemerkungen

Verwenden Sie diese Member-Funktion, um ein-Objekt zu erstellen CDocTemplate . Weisen Sie ein CDocTemplate -Objekt dynamisch zu, und übergeben Sie es an CWinApp:: AddDocTemplate aus der InitInstance Member-Funktion Ihrer Anwendungsklasse.

CDocTemplate:: closealldocuments

Mit dieser Member-Funktion schließen Sie alle geöffneten Dokumente.

virtual void CloseAllDocuments(BOOL bEndSession);

Parameter

bendsitzung
Wird nicht verwendet.

Bemerkungen

Diese Member-Funktion wird in der Regel als Teil des File Exit-Befehls verwendet. Die Standard Implementierung dieser Funktion Ruft die CDocument::D eletecontents -Member-Funktion auf, um die Daten des Dokuments zu löschen, und schließt dann die Rahmen Fenster für alle Sichten, die an das Dokument angefügt sind.

Überschreiben Sie diese Funktion, wenn Sie festlegen möchten, dass der Benutzer vor dem Schließen des Dokuments eine spezielle Bereinigungs Verarbeitung durchführt. Wenn das Dokument beispielsweise einen Datensatz in einer Datenbank darstellt, empfiehlt es sich, diese Funktion zu überschreiben, um die Datenbank zu schließen.

CDocTemplate:: kreatenewdocument

Rufen Sie diese Member-Funktion auf, um ein neues Dokument mit dem Typ zu erstellen, der dieser Dokument Vorlage zugeordnet ist.

virtual CDocument* CreateNewDocument();

Rückgabewert

Ein Zeiger auf das neu erstellte Dokument oder NULL, wenn ein Fehler auftritt.

CDocTemplate:: kreatenewframe

Erstellt ein neues Rahmen Fenster, das ein Dokument und eine Ansicht enthält.

virtual CFrameWnd* CreateNewFrame(
    CDocument* pDoc,
    CFrameWnd* pOther);

Parameter

pDoc
Das Dokument, auf das das neue Rahmen Fenster verweisen soll. Kann den Wert NULL haben.

nach oben
Das Rahmen Fenster, auf dem das neue Rahmen Fenster basieren soll. Kann den Wert NULL haben.

Rückgabewert

Ein Zeiger auf das neu erstellte Rahmen Fenster oder NULL, wenn ein Fehler auftritt.

Bemerkungen

CreateNewFrame verwendet die- CRuntimeClass Objekte, die an den-Konstruktor übergeben werden, um ein neues Rahmen Fenster mit angefügter Ansicht und Dokument zu erstellen. Wenn der Pdoc -Parameter NULL ist, gibt das Framework eine Ablauf Verfolgungs Meldung aus.

Der pother -Parameter wird verwendet, um den Windows New-Befehl zu implementieren. Es stellt ein Rahmen Fenster bereit, in dem das neue Rahmen Fenster modelliert werden kann. Das neue Rahmen Fenster wird normalerweise unsichtbar erstellt. Rufen Sie diese Funktion auf, um Rahmen Fenster außerhalb der Standard Framework-Implementierung von "Datei neu" und "Datei öffnen" zu erstellen

CDocTemplate:: kreateoleframe

Erstellt ein OLE-Rahmen Fenster.

CFrameWnd* CreateOleFrame(
    CWnd* pParentWnd,
    CDocument* pDoc,
    BOOL bCreateView);

Parameter

pparser
Ein Zeiger auf das übergeordnete Fenster des Frames.

pDoc
Ein Zeiger auf das Dokument, auf das das neue OLE-Rahmen Fenster verweisen soll.

bkreateview
Bestimmt, ob eine Ansicht zusammen mit dem Frame erstellt wird.

Rückgabewert

Ein Zeiger auf ein Rahmen Fenster, wenn erfolgreich. andernfalls NULL.

Bemerkungen

Wenn bkreateview NULL ist, wird ein leerer Frame erstellt.

CDocTemplate:: getdocstring

Ruft eine Zeichenfolge ab, die dem Dokumenttyp zugeordnet ist.

virtual BOOL GetDocString(
    CString& rString,
    enum DocStringIndex index) const;

Parameter

RString
Ein Verweis auf ein- CString Objekt, das die Zeichenfolge enthält, wenn die Funktion zurückgegeben wird.

Index
Ein Index der Teil Zeichenfolge, die aus der Zeichenfolge abgerufen wird, die den Dokumenttyp beschreibt. Dieser Parameter kann einen der folgenden Werte aufweisen:

  • CDocTemplate::windowTitle Der Name, der in der Titelleiste des Anwendungsfensters angezeigt wird (z. b. "Microsoft Excel"). Nur in der Dokument Vorlage für SDI-Anwendungen vorhanden.

  • CDocTemplate::docName Root für den Standarddokument Namen (z. b. "Sheet"). Dieser Stamm plus eine Zahl wird für den Standardnamen eines neuen Dokuments dieses Typs verwendet, wenn der Benutzer den neuen Befehl aus dem Menü Datei auswählt (z. b. "Sheet1" oder "Tabelle2"). Wenn keine Angabe erfolgt, wird als Standardwert "undefiniert" verwendet.

  • CDocTemplate::fileNewName Der Name dieses Dokument Typs. Wenn die Anwendung mehr als einen Dokumenttyp unterstützt, wird diese Zeichenfolge im Dialogfeld "Datei neu" angezeigt (z. b. "Arbeitsblatt"). Wenn kein Wert angegeben wird, kann auf den Dokumenttyp nicht mithilfe des File New-Befehls zugegriffen werden.

  • CDocTemplate::filterName Beschreibung des Dokument Typs und eines Platzhalter Filters, der mit Dokumenten dieses Typs übereinstimmt. Diese Zeichenfolge wird in der Dropdown Liste Dateityp auflisten im Dialogfeld Datei öffnen angezeigt (z. b. "Arbeitsblätter (*. xls)"). Wenn nicht angegeben, ist der Dokumenttyp mit dem Befehl zum Öffnen von Dateien nicht zugänglich.

  • CDocTemplate::filterExt Erweiterung für Dokumente dieses Typs (z. b. ". xls"). Wenn nicht angegeben, ist der Dokumenttyp mit dem Befehl zum Öffnen von Dateien nicht zugänglich.

  • CDocTemplate::regFileTypeId Der Bezeichner für den Dokumenttyp, der in der von Windows verwalteten Registrierungsdatenbank gespeichert werden soll. Diese Zeichenfolge ist nur für die interne Verwendung vorgesehen (z. b. "excelworksheet"). Wenn nichts angegeben ist, kann der Dokumenttyp nicht beim Windows-Datei-Manager registriert werden.

  • CDocTemplate::regFileTypeName Der Name des Dokument Typs, der in der Registrierungsdatenbank gespeichert werden soll. Diese Zeichenfolge kann in Dialogfeldern der Anwendungen angezeigt werden, die auf die Registrierungsdatenbank zugreifen (z. b. "Microsoft Excel-Arbeitsblatt").

Rückgabewert

Ungleich NULL, wenn die angegebene Teil Zeichenfolge gefunden wurde. andernfalls 0.

Bemerkungen

Mit dieser Funktion rufen Sie eine bestimmte Teil Zeichenfolge ab, die den Dokumenttyp beschreibt. Die Zeichenfolge, die diese Teil Zeichenfolgen enthält, wird in der Dokument Vorlage gespeichert und aus einer Zeichenfolge in der Ressourcen Datei für die Anwendung abgeleitet. Das Framework ruft diese Funktion auf, um die benötigten Zeichen folgen für die Benutzeroberfläche der Anwendung zu erhalten. Wenn Sie eine Dateinamenerweiterung für die Dokumente Ihrer Anwendung angegeben haben, ruft das Framework auch diese Funktion auf, wenn der Windows-Registrierungsdatenbank ein Eintrag hinzugefügt wird. Dadurch können Dokumente über den Windows-Datei-Manager geöffnet werden.

Diese Funktion wird nur aufgerufen, wenn Sie eine eigene Klasse von ableiten CDocTemplate .

CDocTemplate:: getfirstdocposition

Ruft die Position des ersten Dokuments ab, das dieser Vorlage zugeordnet ist.

virtual POSITION GetFirstDocPosition() const = 0;

Rückgabewert

Ein Positionswert, der verwendet werden kann, um die Liste der dieser Dokument Vorlage zugeordneten Dokumente zu durchlaufen. oder NULL, wenn die Liste leer ist.

Bemerkungen

Verwenden Sie diese Funktion, um die Position des ersten Dokuments in der Liste der Dokumente, die dieser Vorlage zugeordnet sind, zu erhalten. Verwenden Sie den Positionswert als Argument für CDocTemplate:: getnextdoc , um die Liste der der Vorlage zugeordneten Dokumente zu durchlaufen.

CSingleDocTemplate und CMultiDocTemplate überschreiben diese reine virtuelle Funktion. Jede Klasse, von der Sie ableiten, CDocTemplate muss diese Funktion ebenfalls überschreiben.

CDocTemplate:: getnextdoc

Ruft das Listenelement ab, das von RPOs identifiziert wird, und legt dann RPOs auf den Positionswert des nächsten Eintrags in der Liste fest.

virtual CDocument* GetNextDoc(POSITION& rPos) const = 0;

Rückgabewert

Ein Zeiger auf das nächste Dokument in der Liste der dieser Vorlage zugeordneten Dokumente.

Parameter

rPos
Ein Verweis auf einen Positionswert, der von einem vorherigen Rückruf von getfirstdocposition oder zurückgegeben wurde GetNextDoc .

Bemerkungen

Wenn das abgerufene Element das letzte in der Liste ist, wird der neue Wert von RPOs auf NULL festgelegt.

Sie können GetNextDoc in einer Forward-Iterations Schleife verwenden, wenn Sie die ursprüngliche Position mit einem Aufrufen von getfirstdocpositionfestlegen.

Sie müssen sicherstellen, dass der Positionswert eine gültige Position in der Liste darstellt. Wenn Sie ungültig ist, wird die Debugversion des Microsoft Foundation Class-Bibliothek Assert.

CDocTemplate:: initialupdateframe

Initialisiert das Rahmen Fenster und macht es optional sichtbar.

virtual void InitialUpdateFrame(
    CFrameWnd* pFrame,
    CDocument* pDoc,
    BOOL bMakeVisible = TRUE);

Parameter

pFrame
Das Rahmen Fenster, das das erste Update benötigt.

pDoc
Das Dokument, dem der Frame zugeordnet ist. Kann den Wert NULL haben.

bmakevisible
Gibt an, ob der Frame sichtbar und aktiv werden soll.

Bemerkungen

Wird aufgerufen, IntitialUpdateFrame nachdem ein neuer Frame mit erstellt wurde CreateNewFrame . Das Aufrufen dieser Funktion bewirkt, dass die Ansichten in diesem Rahmen Fenster Ihre OnInitialUpdate Aufrufe empfangen. Wenn zuvor noch keine aktive Ansicht vorhanden war, wird die primäre Ansicht des Rahmen Fensters aktiv. die primäre Ansicht ist eine Ansicht mit der untergeordneten ID AFX_IDW_PANE_FIRST. Schließlich wird das Rahmen Fenster sichtbar gemacht, wenn bmakevisible ungleich 0 (null) ist. Wenn bmakevisible gleich 0 (null) ist, bleiben der aktuelle Fokus und der sichtbare Zustand des Rahmen Fensters unverändert.

Es ist nicht erforderlich, diese Funktion aufzurufen, wenn Sie die Implementierung des Frameworks von Datei New und Datei Open verwenden.

CDocTemplate:: LoadTemplate

Lädt die Ressourcen für eine angegebene CDocTemplate oder eine abgeleitete Klasse.

virtual void LoadTemplate();

Bemerkungen

Diese Member-Funktion wird vom Framework aufgerufen, um die Ressourcen für eine angegebene CDocTemplate oder abgeleitete Klasse zu laden. Normalerweise wird Sie während der Erstellung aufgerufen, außer wenn die Vorlage Global erstellt wird. In diesem Fall wird der Aufruf von LoadTemplate verzögert, bis CWinApp:: AddDocTemplate aufgerufen wird.

CDocTemplate:: matchdoctype

Bestimmt den Grad des Konfidenz Werts in der Übereinstimmung zwischen einem Dokumenttyp und dieser Vorlage.

virtual Confidence MatchDocType(
    LPCTSTR lpszPathName,
    CDocument*& rpDocMatch);

Parameter

lpszpathname
Pfadname der Datei, deren Typ bestimmt werden soll.

rpdocmatch
Zeiger auf ein Dokument, dem das übereinstimmende Dokument zugewiesen ist, wenn die von lpszpathname angegebene Datei bereits geöffnet ist.

Rückgabewert

Ein Wert aus der Konfidenz Enumeration, der wie folgt definiert wird:

enum Confidence
    {
    noAttempt,
    maybeAttemptForeign,
    maybeAttemptNative,
    yesAttemptForeign,
    yesAttemptNative,
    yesAlreadyOpen
    };

Bemerkungen

Verwenden Sie diese Funktion, um den Typ der Dokument Vorlage zu bestimmen, die zum Öffnen einer Datei verwendet werden soll. Wenn Ihre Anwendung mehrere Dateitypen unterstützt, können Sie mit dieser Funktion beispielsweise ermitteln, welche der verfügbaren Dokumentvorlagen für eine bestimmte Datei geeignet ist, indem Sie MatchDocType für jede Vorlage nacheinander aufrufen und eine Vorlage entsprechend dem zurückgegebenen Vertrauens Wert auswählen.

Wenn die von lpszpathname angegebene Datei bereits geöffnet ist, gibt diese Funktion zurück CDocTemplate::yesAlreadyOpen und kopiert das Datei CDocument Objekt bei rpdocmatch in das-Objekt.

Wenn die Datei nicht geöffnet ist, aber die Erweiterung in lpszpathname mit der durch angegebenen Erweiterung übereinstimmt CDocTemplate::filterExt , gibt diese Funktion zurück CDocTemplate::yesAttemptNative und legt rpdocmatch auf NULL fest. Weitere Informationen zu CDocTemplate::filterExt finden Sie unter CDocTemplate:: getdocstring.

Wenn keiner der Fälle true ist, gibt die Funktion zurück CDocTemplate::yesAttemptForeign .

Die Standard Implementierung gibt nicht CDocTemplate::maybeAttemptForeign oder zurück CDocTemplate::maybeAttemptNative . Überschreiben Sie diese Funktion, um eine für die Anwendung geeignete typübereinstimmungs Logik zu implementieren, und verwenden Sie möglicherweise diese beiden Werte aus der Konfidenz Auflistung

CDocTemplate:: OpenDocumentFile

Öffnet eine Datei, die durch einen Pfad angegeben wird.

virtual CDocument* OpenDocumentFile(LPCTSTR lpszPathName) = 0;

virtual CDocument* OpenDocumentFile(
    LPCTSTR lpszPathName,
    BOOL bAddToMRU) = 0;

Parameter

lpszpathname
in Zeiger auf den Pfad der Datei, die das zu öffnende Dokument enthält.

baddtomru
in TRUE gibt an, dass das Dokument eine der aktuellsten Dateien ist. FALSE gibt an, dass das Dokument nicht eine der aktuellsten Dateien ist.

Rückgabewert

Ein Zeiger auf das Dokument, dessen Datei von lpszpathname; benannt wird. NULL, wenn nicht erfolgreich.

Bemerkungen

Öffnet die Datei, deren Pfad von lpszpathname angegeben wird. Wenn lpszpathname NULL ist, wird eine neue Datei erstellt, die ein Dokument mit dem dieser Vorlage zugeordneten Typ enthält.

CDocTemplate:: RemoveDocument

Entfernt das Dokument, auf das von Pdoc verwiesen wird, aus der Liste der Dokumente, die dieser Vorlage zugeordnet sind.

virtual void RemoveDocument(CDocument* pDoc);

Parameter

pDoc
Zeiger auf das zu entfernende Dokument.

Bemerkungen

Die abgeleiteten Klassen CMultiDocTemplate und über CSingleDocTemplate schreiben diese Funktion. Wenn Sie Ihre eigene Dokumentvorlagen Klasse von ableiten CDocTemplate , muss die abgeleitete Klasse diese Funktion überschreiben.

CDocTemplate:: saveallmodified

Speichert alle Dokumente, die geändert wurden.

virtual BOOL SaveAllModified();

Rückgabewert

Ungleich 0 (null), wenn erfolgreich; andernfalls 0.

CDocTemplate:: setcontainerinfo

Bestimmt die Ressourcen für OLE-Container, wenn ein direktes OLE-Element bearbeitet wird.

void SetContainerInfo(UINT nIDOleInPlaceContainer);

Parameter

nidoleingeplacecontainer
Die ID der Ressourcen, die verwendet werden, wenn ein eingebettetes Objekt aktiviert wird.

Bemerkungen

Mit dieser Funktion können Sie die Ressourcen festlegen, die verwendet werden sollen, wenn ein OLE-Objekt direkt aktiviert wird. Diese Ressourcen können Menüs und Zugriffstasten Tabellen enthalten. Diese Funktion wird in der Regel in der CWinApp:: InitInstance -Funktion Ihrer Anwendung aufgerufen.

Das Menü, das nidoleinplacecontainer zugeordnet ist, enthält Trennzeichen, mit denen das Menü des aktivierten direkten Elements mit dem Menü der Containeranwendung zusammengeführt werden kann. Weitere Informationen zum Zusammenführen von Server-und Container Menüs finden Sie im Artikel Menüs und Ressourcen (OLE).

CDocTemplate:: setdefaulttitle

Mit dieser Funktion wird der Standard Titel des Dokuments geladen und in der Titelleiste des Dokuments angezeigt.

virtual void SetDefaultTitle(CDocument* pDocument) = 0;

Parameter

pdocument
Zeiger auf das Dokument, dessen Titel festgelegt werden soll.

Bemerkungen

Weitere Informationen zum Standard Titel finden Sie in der Beschreibung von CDocTemplate::docName in CDocTemplate:: getdocstring.

CDocTemplate:: setserverinfo

Bestimmt die Ressourcen und Klassen, wenn das Server Dokument direkt eingebettet oder bearbeitet wird.

void SetServerInfo(
    UINT nIDOleEmbedding,
    UINT nIDOleInPlaceServer = 0,
    CRuntimeClass* pOleFrameClass = NULL,
    CRuntimeClass* pOleViewClass = NULL);

Parameter

nidoleeinbettungen
Die ID der Ressourcen, die verwendet werden, wenn ein eingebettetes Objekt in einem separaten Fenster geöffnet wird.

nidoleingeplaceserver
Die ID der Ressourcen, die verwendet werden, wenn ein eingebettetes Objekt direkt aktiviert wird.

poleframeclass
Ein Zeiger auf eine CRuntimeClass -Struktur, die Klassen Informationen für das Rahmen Fenster Objekt enthält, das erstellt wird, wenn die direkte Aktivierung stattfindet.

poleviewclass
Ein Zeiger auf eine- CRuntimeClass Struktur, die Klassen Informationen für das Ansichts Objekt enthält, das erstellt wird, wenn die direkte Aktivierung erfolgt.

Bemerkungen

Mit dieser Member-Funktion können Sie Ressourcen identifizieren, die von der Serveranwendung verwendet werden, wenn der Benutzer die Aktivierung eines eingebetteten Objekts anfordert. Diese Ressourcen bestehen aus Menüs und Zugriffstasten Tabellen. Diese Funktion wird in der Regel in der InitInstance Ihrer Anwendung aufgerufen.

Das Menü, das nidoleinplaceserver zugeordnet ist, enthält Trennzeichen, mit denen das Server Menü mit dem Menü des Containers zusammengeführt werden kann. Weitere Informationen zum Zusammenführen von Server-und Container Menüs finden Sie im Artikel Menüs und Ressourcen (OLE).

CDocTemplate:: "kreatepreviewframe"

Erstellt einen für Rich Preview verwendeten untergeordneten Frame.

CFrameWnd* CreatePreviewFrame(
    CWnd* pParentWnd,
    CDocument* pDoc);

Parameter

pparser
Ein Zeiger auf ein übergeordnetes Fenster (in der Regel von der Shell bereitgestellt).

pDoc
Ein Zeiger auf ein Dokument Objekt, dessen Inhalt in der Vorschau angezeigt wird.

Rückgabewert

Ein gültiger Zeiger auf ein- CFrameWnd Objekt oder NULL, wenn die Erstellung fehlschlägt.

Bemerkungen

CDocTemplate:: setpreviewinfo

Richtet den Out-of-Process-Vorschau Handler ein.

void SetPreviewInfo(
    UINT nIDPreviewFrame,
    CRuntimeClass* pPreviewFrameClass = NULL,
    CRuntimeClass* pPreviewViewClass = NULL);

Parameter

nidpreviewframe
Gibt eine Ressourcen-ID des Vorschau Rahmens an.

ppreviewframeclass
Gibt einen Zeiger auf eine Lauf Zeit Klassen-Informationsstruktur des Vorschau Rahmens an.

ppreviewviewclass
Gibt einen Zeiger auf eine Lauf Zeit Klassen-Informationsstruktur der Vorschau Ansicht an.

Bemerkungen

Siehe auch

CCmdTarget-Klasse
Hierarchie Diagramm
CSingleDocTemplate-Klasse
CMultiDocTemplate-Klasse
CDocument-Klasse
CView-Klasse
CScrollView-Klasse
CEditView-Klasse
CFormView-Klasse
CFrameWnd-Klasse
CMDIChildWnd-Klasse