CDocument::OnNewDocument

项目
03/01/2013

调用由结构作为文件的命令的一部分。

virtual BOOL OnNewDocument( );

返回值

非零，如果文档成功初始化为;否则为0。

备注

此的默认实现函数调用 DeleteContents 成员函数确保文档为空然后指示新的文档如干净。重写此函数初始化新文档的数据结构。您应调用此函数的基类版本与您的重写。

如果用户选择在SDI应用程序的文件的命令，则框架使用此功能重新初始化现有文档，而不是创建新的。如果用户选择文件新在多文档界面(mdi) (MDI)应用程序，结构每次创建新文档然后调用此函数来初始化它。在此函数必须将初始化代码而不是文件中新命令的构造函数可以有效在SDI应用程序。

请注意具有 OnNewDocument 将调用的大小写。发生这种情况时，必须遵守文档时，在ActiveX文档服务器。函数在 CreateInstance 方法(显示 COleObjectFactory派生类)和第二次之前先调用以 InitNew 方法(显示 COleServerDoc从派生的类）。

示例

下面的示例演示初始化文档对象替代方法。

// Method 1: In an MDI application, the simplest place to do 
// initialization is in the document constructor.  The framework 
// always creates a new document object for File New or File Open.
CExampleDoc::CExampleDoc()
{
   // Do initialization of MDI document here.
}

// Method 2: In an SDI or MDI application, do all initialization 
// in an override of OnNewDocument, if you are certain that
// the initialization is effectively saved upon File Save
// and fully restored upon File Open, via serialization.
BOOL CMyDoc::OnNewDocument()
{
   if (!CDocument::OnNewDocument())
      return FALSE;

   // Do initialization of new document here.

   return TRUE;
}

// Method 3: If the initialization of your document is not
// effectively saved and restored by serialization (during File Save
// and File Open), then implement the initialization in single
// function (named InitMyDocument in this example).  Call the
// shared initialization function from overrides of both
// OnNewDocument and OnOpenDocument.
BOOL CExampleDoc::OnNewDocument()
{
   if (!CDocument::OnNewDocument())
      return FALSE;

   InitMyDocument(); // call your shared initialization function

   // If your new document object requires additional initialization
   // not necessary when the document is deserialized via File Open,
   // then perform that additional initialization here.

   return TRUE;
}