VS报错：“创建空文档失败”

在VS2015上的一个项目中，运行时提示创建空文档失败，为了找错大费周章。

 

 

首先可以确定报错是在创建界面以前就报的错。所以在代码的OnCreate等初始化函数的入口打上断点，一步一步调试。受网上的启发，最后发现是在MainFrame的OnCreate中返回了-1，导致的错误，然后提示的错误信息。在我的OnCreate中再往里面查，发现有一个XXOCX的createOCX出的错，可以联想到很可能是ocx的控件没有注册。注册成功之后，果然不再报错了。

 

【附】网上对我有用的资料

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

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

这类问题的出现主要在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 也会导致弹出“建立空文档失败”。
******************************************************************

以上就是我分析的 出现这样“建立空文档失败”问题的大致原因。