Fail to create empty document!

[wweric]

我的程序当debug模式运行时，正常。但用Release模式时，就会出现“Fail to create empty document!”的错误，请高手指教。

[huaboy408]

ZT

关于"建立空文档失败"的问题的分析！

许多新手在遇到此类问题时总是措手无策，如果谁有耐心就看看我写的下面这片文章吧。

这类问题的出现主要在BOOL CWinApp::ProcessShellCommand(CCommandLineInfo& rCmdInfo);

函数的关键内容：
BOOL bResult = TRUE;
switch (rCmdInfo.m_nShellCommand)
{
case CCommandLineInfo::FileNew: // 新建
if (!AfxGetApp()->OnCmdMsg(ID_FILE_NEW, 0, NULL, NULL))
OnFileNew();
if (m_pMainWnd == NULL)
bResult = FALSE;
break;
case CCommandLineInfo::FileOpen:
if (!OpenDocumentFile(rCmdInfo.m_strFileName))
bResult = FALSE;
break;
通过上面的内容我们可以看出：如果没有对ID_FILE_NEW做映射的话出现问题就在OnFileNew();
CWinApp对OnFileNew的默认实现是调用m_pDocManager->OnFileNew();

我们继续解析CDocManager,它究竟干了些什么？
（首先说明一下CDocManager它主要的功能是帮助CWinApp是管理文档模板链表和注册文件类型.）

//如果模板列表为空的话
if (m_templateList.IsEmpty())
{
TRACE0("Error: no document templates registered with CWinApp.\n");
AfxMessageBox(AFX_IDP_FAILED_TO_CREATE_DOC); //报错并返回.这里不会报建立新文档出错。
return;
}

CDocTemplate* pTemplate = (CDocTemplate*)m_templateList.GetHead();
if (m_templateList.GetCount() > 1)
{
// more than one document template to choose from
// bring up dialog prompting user
CNewTypeDlg dlg(&m_templateList);
int nID = dlg.DoModal();
if (nID == IDOK)
pTemplate = dlg.m_pSelectedTemplate;
else
return; // none - cancel operation
}

ASSERT(pTemplate != NULL);
ASSERT_KINDOF(CDocTemplate, pTemplate);

pTemplate->OpenDocumentFile(NULL);

通过上面的代码我们可以看出，CWinApp的OnFileNew和OnFileOpen分别调用CDocManager的虚拟函数OnFileNew

和OnFileOpen。而在CDocManager里面。通过模板链表选择不同的模板来调用文档模板的OpenDocumentFile();
如果传入参数NULL表示新建文件。

下面我们来看看CDocTemplate::OpenDocumentFile()它是一个最关键的函数。因为他是虚拟函数，我们考虑
CSingleDocTemplate::OpenDocumentFile的情况。
这个函数里面有一段代码：
其中：AFX_IDP_FAILED_TO_CREATE_DOC 就是字符“建立空文档失败”的资源id
// create a new document
pDocument = CreateNewDocument();
ASSERT(pFrame == NULL); // will be created below
bCreated = TRUE;
if (pDocument == NULL)
{
AfxMessageBox(AFX_IDP_FAILED_TO_CREATE_DOC);
return NULL;
}
ASSERT(pDocument == m_pOnlyDoc);
if (pFrame == NULL)
{
ASSERT(bCreated);

// create frame - set as main document frame
BOOL bAutoDelete = pDocument->m_bAutoDelete;
pDocument->m_bAutoDelete = FALSE;
// don't destroy if something goes wrong
pFrame = CreateNewFrame(pDocument, NULL);
pDocument->m_bAutoDelete = bAutoDelete;
if (pFrame == NULL)
{
AfxMessageBox(AFX_IDP_FAILED_TO_CREATE_DOC);
delete pDocument; // explicit delete on error
return NULL;
}

通过观察上面的代码我们很容易的看出 有两个可能出错的原因：1 CreateNewDocument返回为NULL 2

CreateNewFrame 返回为空。

先看 CreateNewDocument() 一般来说这个函数很少失败。不过在调试时也不能掉以轻心。
再看看CreateNewFrame() 里面有一个函数LoadFrame是造成这种“建立新文档失败”错误的源泉所在。
只要它返回False就会弹出这样的提示。
我们在来看看LoadFrame() 里面调用CFrameWnd::Create()来创建窗口，创建窗口失败返回Fasle。
这样问题就变的比较简单了。

看看Create和CreateEx函数的动作就知道怎么回事了。
****************************************************************
1 如果找不到菜单资源 返回False 同时也弹出“建立空文档失败”
HINSTANCE hInst = AfxFindResourceHandle(lpszMenuName, RT_MENU);
if ((hMenu = ::LoadMenu(hInst, lpszMenuName)) == NULL)
{
TRACE0("Warning: failed to load menu for CFrameWnd.\n");
PostNcDestroy(); // perhaps delete the C++ object
return FALSE;
}
2 重载了PreCreateWindow而且返回False也会导致弹出“建立空文档失败”
3 在OnCreate 里面返回-1 也会导致弹出“建立空文档失败”。
******************************************************************

以上就是我分析的 出现这样“建立空文档失败”问题的大致原因。也许还有其他的原因。我这里就不一一列举

了。

说实话遇到此类问题，如果是新手的话，是很难解决的。我写这篇文档就当是抛砖引玉吧。
我的Email: [e-mail]

[蒋晟]

建立空文档失败的同时在调试输出窗口应该有更详细的错误报告

[yuantao]

厉害, 楼上的高明.