CSingleDocTemplate::CSingleDocTemplate

Artigo
02/25/2013

Constrói um objeto de CSingleDocTemplate .

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

Parâmetros

nIDResource
Especifica a identificação dos recursos usados com o tipo de documento.Isso pode incluir o menu, o ícone, a tabela de aceleração, e recursos de cadeia de caracteres.

O recurso de cadeia de caracteres que consiste em sete subcadeias de caracteres separadas pelo caractere ““\ n” caractere (\ n” é necessário como um espaço reservado se uma subcadeia de caracteres não é incluída; no entanto, os caracteres “\ n de arrasto” não são necessários;) essas subcadeias de caracteres descrevem o tipo de documento.Para obter informações sobre as subcadeias de caracteres, consulte CDocTemplate::GetDocString.Este recurso de cadeia de caracteres for encontrado no arquivo 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 editar essa cadeia de caracteres usando o editor de cadeia de caracteres; a cadeia de caracteres inteira aparece como uma única entrada no editor de cadeia de caracteres, não como sete entradas separadas.

Para obter mais informações sobre esses tipos de recursos, consulte Editor de Cadeia de Caracteres.
pDocClass
Os pontos ao objeto de CRuntimeClass de documento classe.Essa classe é CDocument- classe derivada que você define para representar os documentos.
pFrameClass
Os pontos ao objeto de CRuntimeClass da janela do quadro classe.Essa classe pode ser CFrameWnd- a classe derivada, ou podem ser CFrameWnd próprio se você deseja o comportamento padrão para sua janela de quadro chave.
pViewClass
Os pontos ao objeto de CRuntimeClass de exibição classe.Essa classe é CView- classe derivada que você define para exibir os documentos.

Comentários

Atributos dinamicamente um objeto de CSingleDocTemplate e passe a CWinApp::AddDocTemplate da função de membro de InitInstance de sua classe do 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);