CSingleDocTemplate::CSingleDocTemplate

Artigo
08/25/2010

Constrói um CSingleDocTemplate objeto.

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

Parâmetros

nIDResource
Especifica a ID de recursos usado com o tipo de documento.Isso pode incluir o menu, ícone, tabela de acelerador e recursos de seqüência de caracteres.

O recurso de cadeia de caracteres consiste em até sete substrings separados pelo caractere '\n' (o caractere '\n' é necessário sistema autônomo um espaço reservado se uma subseqüência não está incluída; no entanto, à direita '\n' caracteres não são necessários); esses substrings descrevem o tipo de documento.Para obter informações sobre as subseqüências, consulte CDocTemplate::GetDocString.Esse recurso de cadeia de caracteres for encontrado no arquivo de recurso do aplicativo.Por exemplo:

// MYCALC.RC

STRINGTABLE PRELOAD DISCARDABLE

BEGIN

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

END

Você pode edição essa seqüência de caracteres usando o editor de seqüência de caracteres; toda a seqüência de caracteres aparece sistema autônomo uma única entrada no Editor de String, não sistema autônomo sete entradas separadas.

Para obter mais informações sobre esses tipos de recursos, consulte o Editor de seqüência de caracteres.
pDocClass
Aponta para o CRuntimeClass objeto da classe do documento. Essa classe é um CDocument-você define para representar seus documentos de classe derivada.
pFrameClass
Aponta para o CRuntimeClass objeto da classe de janela de quadro. Essa classe pode ser um CFrameWnd-classe derivada ou pode ser CFrameWnd si mesmo se você desejar o comportamento padrão para sua janela do quadro principal.
pViewClass
Aponta para o CRuntimeClass objeto da classe de modo de exibição. Essa classe é um CView-definir para exibir os documentos de classe derivada.

Comentários

Alocar dinamicamente um CSingleDocTemplate objeto e passá-lo para CWinApp::AddDocTemplate do InitInstance função de membro de sua classe de aplicativo.

Exemplo

// 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);