CSingleDocTemplate::CSingleDocTemplate

Artikel
02/26/2013

Erstellt ein CSingleDocTemplate-Objekt.

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

Parameter

nIDResource
Gibt die ID der Ressourcen an, die dem Dokumenttyp verwendet werden.Dies kann Menü, Symbol, Zugriffstastentabelle und Zeichenfolgenressourcen ein.

Die Zeichenfolgenressource besteht aus bis zu sieben Teilzeichenfolgen, die vom "\ n" Zeichen getrennt werden (das "\ n" Zeichen wird als Platzhalter erforderlich, wenn eine Teilzeichenfolge nicht eingeschlossen ist, jedoch Abschließendes "\ n" sind Zeichen nicht notwendig); diese Teilzeichenfolgen beschreiben den Dokumenttyp.Informationen über die Teilzeichenfolgen, finden Sie unter CDocTemplate::GetDocString.Diese Zeichenfolgenressource wird in der Ressourcendatei der Anwendung gefunden.Beispiel:

// MYCALC.RC

STRINGTABLE PRELOAD DISCARDABLE

BEGIN

IDR_MAINFRAME "MyCalc Windows Application\nSheet\nWorksheet\n Worksheets (*.myc)\n.myc\nMyCalcSheet\n MyCalc Worksheet"

END

Sie können diese Zeichenfolge mit dem Zeichenfolgen-Editor bearbeiten; die gesamte Zeichenfolge wird als einzelner Eintrag im Editor, nicht als sieben mehrere Einträge.

Weitere Informationen zu diesen Ressourcentypen, finden Sie unter Zeichenfolgen-Editor.
pDocClass
Zeigt auf CRuntimeClass-Objekt der Dokumentklasse.Diese Klasse ist CDocument von abgeleitete Klasse, die Sie definieren, um die Dokumente darzustellen.
pFrameClass
Zeigt auf CRuntimeClass-Objekt des Rahmenfensters darstellen.Diese Klasse kann CFrameWnd sein von abgeleitete Klasse oder es können CFrameWnd sein, selbst wenn Sie Standardverhalten für das Hauptrahmenfenster soll.
pViewClass
Zeigt auf CRuntimeClass-Objekt der Ansichtsklasse.Diese Klasse ist CView von abgeleitete Klasse, die Sie definieren, um die Dokumente anzuzeigen.

Hinweise

Ordnen Sie dynamisch ein CSingleDocTemplate-Objekt zu und führen Sie es CWinApp::AddDocTemplate aus der InitInstance-Memberfunktion der Anwendungsklasse.

Beispiel

// The following code fragment is from CMyWinApp::InitInstance.
// CMyWinApp is derived from CWinApp.

// Establish the document type
// supported by the application
AddDocTemplate(new CSingleDocTemplate(IDR_MAINFRAME,
   RUNTIME_CLASS(CMyDoc),
   RUNTIME_CLASS(CMainFrame),       // main SDI frame window
   RUNTIME_CLASS(CMyView)));

// The following code fragment is from CMyWinApp::InitInstance.
// CMyWinApp is derived from CWinApp.

// Normally, an application creates a document
// template and registers it with MFC as a part
// of its initialization.

// IDR_SAMPLERESOURCE is a resource ID string;
// see the CDocTemplate class overview documentation
// for more information on its format.

// The next three parameters use the RUNTIME_CLASS()
// macro to get runtime type information for the doc,
// frame, and view classes that will be associated by
// the template.

CSingleDocTemplate* pDocTemplate;
pDocTemplate = new CSingleDocTemplate(IDR_MAINFRAME,
   RUNTIME_CLASS(CMyDoc),
   RUNTIME_CLASS(CMainFrame),       // main SDI frame window
   RUNTIME_CLASS(CMyView));
if (!pDocTemplate)
   return FALSE;

// After the following call, MFC is aware of the doc
// template and will free it when the application is
// shut down. The doc templates known to MFC will
// automatically be used when CWinApp:OnFileOpen() or 
// CWinApp::OnFileNew() are called.
AddDocTemplate(pDocTemplate);