CDocTemplate-Klasse

Artikel
02/26/2013

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

class CDocTemplate : public CCmdTarget

Mitglieder

Geschützte Konstruktoren

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

Öffentliche Methoden

Name	Beschreibung
CDocTemplate::AddDocument	Fügt ein Dokument einer Vorlage hinzu.
CDocTemplate::CloseAllDocuments	Schließt alle Dokumente, die dieser Vorlage zugeordnet sind.
CDocTemplate::CreateNewDocument	Erstellt ein neues Dokument.
CDocTemplate::CreateNewFrame	Stellt ein neues Rahmenfenster erstellt, das ein Dokument und eine Ansicht enthält.
CDocTemplate::CreateOleFrame	Stellt ein OLE-aktiviertes Rahmenfenster erstellt.
CDocTemplate::CreatePreviewFrame	Erstellt untergeordneter Frame, die für Reich-Vorschau verwendet werden.
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 der folgenden ab.
CDocTemplate::InitialUpdateFrame	Initialisiert das Rahmenfenster, und macht es optional sichtbar.
CDocTemplate::LoadTemplate	Lädt die Ressourcen von angegebenen CDocTemplate oder eine abgeleitete Klasse.
CDocTemplate::MatchDocType	Bestimmt den Grad des Abhängigkeit in der Übereinstimmung zwischen einem Dokumenttyp und dieser Vorlage.
CDocTemplate::OpenDocumentFile	Öffnet eine Datei, die durch einen Pfadnamen angegeben wird.
CDocTemplate::RemoveDocument	Entfernt ein Dokument aus einer Vorlage.
CDocTemplate::SaveAllModified	Speichert alle Dokumente, die dieser Vorlage zugeordnet werden, die geändert wurden.
CDocTemplate::SetContainerInfo	Bestimmt die Ressourcen für OLE-Container, wenn, direktes Bearbeiten von OLE-Element.
CDocTemplate::SetDefaultTitle	Zeigt den standardmäßigen Namen in der Titelleiste des Dokumentfensters an.
CDocTemplate::SetPreviewInfo	richtet aus Prozessvorschauhandler heraus.
CDocTemplate::SetServerInfo	Bestimmt die Ressourcen und Klassen, wenn das Serverdokument oder bearbeitetes direkt eingebettet ist.

Hinweise

Sie erstellen gewöhnlich eine oder mehrere Dokumentvorlagen in der Implementierung von InitInstance-Funktion der Anwendung.Eine Normal-Vorlage definiert die Beziehungen zwischen drei Typen Klassen:

Eine Dokumentklasse, die Sie von CDocument berechnen.
Eine Ansichtsklasse, die Daten aus der Dokumentklasse anzeigt, lässt oben auf.Sie können diese Klasse von CView, von CScrollView, von CFormView oder von CEditView berechnen.(Sie können CEditView auch direkt verwenden.)
Eine Rahmenfensterklasse, die die Ansicht enthält.Eine SDI-Anwendung (Single-Document Interface) berechnen Sie diese Klasse von CFrameWnd.Eine Anwendung (Multiple Document Interface) berechnen Sie diese Klasse von CMDIChildWnd.Wenn Sie nicht erforderlich ist, um das Verhalten des Rahmenfensters anzupassen, können Sie CFrameWnd oder CMDIChildWnd direkt verwenden, ohne eine eigene Klasse zu berechnen.

Die Anwendung verfügt über eine Normal-Vorlage für jeden Typ Dokument, den sie unterstützt.Wenn die Anwendung beispielsweise Arbeitsblätter und Textdokumente unterstützt, kann die Anwendung beiden Dokumentvorlagenobjekte.Jede Normal-Vorlage ist zum Erstellen und Verwalten aller Dokumente seines Typs zuständig.

Die Normal-Vorlage speichert Zeiger auf CRuntimeClass-Objekten für das Dokument, die Ansicht und die Rahmenfensterklassen.Diese CRuntimeClass-Objekte angegeben werden, wenn eine Normal-Vorlage erstellt.

Die Normal-Vorlage enthält die ID der Ressourcen, die dem Dokumenttyp verwendet werden (wie Menü, Symbol oder Zugriffstastentabellenressourcenn).Die Normal-Vorlage verfügt auch über die Zeichenfolgen, die zusätzliche Informationen zu den Dokumenttyp enthalten.Diese schließen den Namen des Dokumenttyps (beispielsweise, "Arbeitsblatt") und der Dateierweiterung ein (beispielsweise, ".xls").Optional kann es andere Zeichenfolgen enthalten, die von der Benutzeroberfläche der Anwendung, von der Windows-Datei-Manager- und Object Linking and Embedding-(OLE) verwendet werden unterstützt.

Wenn die Anwendung ein OLE-Container und/oder der Server ist, definiert die Normal-Vorlage auch die ID des, das während der direkten Aktivierung verwendet wird.Wenn die Anwendung ein OLE-Server ist, definiert die Normal-Vorlage die ID der Symbolleiste und des, die während der direkten Aktivierung verwendet werden.Sie geben diese zusätzlichen OLE an, indem Sie SetContainerInfo und SetServerInfo aufrufen.

Da CDocTemplate eine abstrakte Klasse ist, können Sie die - Klasse nicht direkt verwenden.Eine typische - Anwendung verwendet ein zwei CDocTemplate- die abgeleiteten Klassen, die von Microsoft Foundation Class-Bibliothek bereitgestellt werden: CSingleDocTemplate, das SDI implementiert, und CMultiDocTemplate, das MDI implementiert.Siehe diese Klassen zu Informationen über die Verwendung von Dokumentvorlagen.

Wenn die Anwendung ein Benutzeroberflächeparadigma erfordert, das zu SDI oder MDI grundlegend unterscheiden, können Sie die eigene Klasse von CDocTemplate berechnen.

Weitere Informationen zu CDocTemplate, finden Sie unter Dokumentvorlagen und der Dokument/Ansichts-Erstellungs-Prozess.