CMDIChildWndEx::GetDocumentName
返回在MDI子窗口中显示文档的名称。
virtual LPCTSTR GetDocumentName(
CObject** pObj
);
返回值
到包含文档的名称的字符串的指针。
备注
文档什么是MDI子窗口显示。 通常,窗口显示加载或保存到文件中的数据。 因此,文档的名称是文件的名称。 GetDocumentName 的默认实现返回从 CDocument::GetPathName获取的字符串。
如果窗口未显示任何从文件中加载的文档,请具有派生类中重写此方法并返回单个文档标识符。
当保存状态所有打开文档时,GetDocumentName 由框架调用。 该返回的字符串写到注册表中。
当框架后时还原状态,文档名称从注册表中读取并传递给 CMDIFrameWndEx::CreateDocumentWindow。 重写在 CMDIFrameWndEx的此方法的派生类并创建或打开具有该名称的文档和写入具有此名称的文件。 如果文档中根据文件,请创建基于文档标识符的文档。 应执行上述操作,仅当要保存,然后恢复文档。
示例
下面的示例演示 GetDocumentName 方法的用法。 此代码段来自 VisualStudioDemo示例:MFC Visual Studio应用程序。
LPCTSTR CChildFrame::GetDocumentName(CObject** pObj)
{
if (DYNAMIC_DOWNCAST(CStartView, GetActiveView()) != NULL)
{
return g_strStartViewName;
}
return CMDIChildWndEx::GetDocumentName(pObj);
}
要求
标头: afxMDIChildWndEx.h