CSingleDocTemplate::CSingleDocTemplate

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

Parameters

nIDResource

Specifies the ID of the resources used with the document type. This may include menu, icon, accelerator table, and string resources.

The string resource consists of up to seven substrings separated by the ‘\n’ character (the ‘\n’ character is needed as a placeholder if a substring is not included; however, trailing ‘\n’ characters are not necessary); these substrings describe the document type. For information about the substrings, see CDocTemplate::GetDocString. This string resource is found in the application’s resource file. For example:

// MYCALC.RC
STRINGTABLE PRELOAD DISCARDABLE
BEGIN
    IDR_MAINFRAME "MyCalc Windows Application\nSheet\nWorksheet\n Worksheets (*.myc)\n.myc\nMyCalcSheet\n MyCalc Worksheet"
END

You can edit this string using the string editor; the entire string appears as a single entry in the String Editor, not as seven separate entries.

For more information about these resource types, see the String Editor (described in the Visual C++ User's Guide).

pDocClass

Points to the CRuntimeClass object of the document class. This class is a CDocument-derived class you define to represent your documents.

pFrameClass

Points to the CRuntimeClass object of the frame window class. This class can be a CFrameWnd-derived class, or it can be CFrameWnd itself if you want default behavior for your main frame window.

pViewClass

Points to the CRuntimeClass object of the view class. This class is a CView-derived class you define to display your documents.

Remarks

Constructs a CSingleDocTemplate object. Dynamically allocate a CSingleDocTemplate object and pass it to CWinApp::AddDocTemplate from the InitInstance member function of your application class.

Example

// example for CSingleDocTemplate::CSingleDocTemplate
BOOL CMyApp::InitInstance()
{
        // ...
        // Establish the document type
        // supported by the application

        AddDocTemplate( new CSingleDocTemplate( IDR_MAINFRAME,
                            RUNTIME_CLASS( CSheetDoc ),
                            RUNTIME_CLASS( CFrameWnd ),
                            RUNTIME_CLASS( CSheetView ) ) );

        // ...
}

CSingleDocTemplate Overview | Class Members | Hierarchy Chart