msdn中居然找不到CDocManager类的说明,网上找到这篇文档,有待分析。
首先有个不明白的地方,我的书上说CDocManager类是不公开的,可是我还是找到了他的类定义和实现,真搞不懂她这个不公开是什么意思??? CDocManager的定义如下:
class CDocManager : public CObject { DECLARE_DYNAMIC(CDocManager) public:
// Constructor CDocManager();
//Document functions virtual void AddDocTemplate(CDocTemplate* pTemplate); virtual POSITION GetFirstDocTemplatePosition() const; virtual CDocTemplate* GetNextDocTemplate(POSITION& pos) const; virtual void RegisterShellFileTypes(BOOL bCompat); void UnregisterShellFileTypes(); virtual CDocument* OpenDocumentFile(LPCTSTR lpszFileName); // open named file virtual BOOL SaveAllModified(); // save before exit virtual void CloseAllDocuments(BOOL bEndSession); // close documents before exiting virtual int GetOpenDocumentCount();
// helper for standard commdlg dialogs virtual BOOL DoPromptFileName(CString& fileName, UINT nIDSTitle, DWORD lFlags, BOOL bOpenFileDialog, CDocTemplate* pTemplate);
//Commands // Advanced: process async DDE request virtual BOOL OnDDECommand(LPTSTR lpszCommand); virtual void OnFileNew(); virtual void OnFileOpen();
// Implementation protected: CPtrList m_templateList; int GetDocumentCount(); // helper to count number of total documents
public: static CPtrList* pStaticList; // for static CDocTemplate objects static BOOL bStaticInit; // TRUE during static initialization static CDocManager* pStaticDocManager; // for static CDocTemplate objects
public: virtual ~CDocManager(); #ifdef _DEBUG virtual void AssertValid() const; virtual void Dump(CDumpContext& dc) const; #endif };
就变量而言,这个类只有四个变量,分别是CPtrList m_templateList,static CPtrList* pStaticList,static BOOL bStaticInit,static CDocManager* pStaticDocManager后面三个都是静态的,目前没有搞明白这三个成员变量是干什么的??在网上找了些资料,谈到这一点的时候,都说无关紧 要,恩,这个是下次心情好时研究的对像。
最重要的变量是CPtrList m_templateList,在普通的mfc程序中的InitInstance()函数中都有一条语句(这里以CMultiDocTemplate为例):
CMultiDocTemplate* pDocTemplate; pDocTemplate = new CMultiDocTemplate( nIDResource, RUNTIME_CLASS(pDocClass), RUNTIME_CLASS(pFrameClass), // custom MDI child frame RUNTIME_CLASS(pViewClass)): AddDocTemplate(pDocTemplate);
正是这个AddDocTemplate(pDocTemplate)函数,看起来好像是一个CWinApp的函数,实际上CWinApp:: AddDocTemplate(pDocTemplate)调用了上面的CDocManager ::AddDocTemplate(CDocTemplate* pTemplate)。如下:
void CWinApp::AddDocTemplate(CDocTemplate* pTemplate) { if (m_pDocManager == NULL) m_pDocManager = new CDocManager; m_pDocManager->AddDocTemplate(pTemplate); }
这里函数里面似乎有个不知出处的m_pDocManager ,呵呵,这个我稍候提出,先来看看m_pDocManager->AddDocTemplate(pTemplate)到底是干什么的??如下:
void CDocManager::AddDocTemplate(CDocTemplate* pTemplate) { if (pTemplate == NULL) { if (pStaticList != NULL) { POSITION pos = pStaticList->GetHeadPosition(); while (pos != NULL) { CDocTemplate* pTemplate = (CDocTemplate*)pStaticList->GetNext(pos); AddDocTemplate(pTemplate); } delete pStaticList; pStaticList = NULL; } bStaticInit = FALSE; } else { ASSERT_VALID(pTemplate); ASSERT(m_templateList.Find(pTemplate, NULL) == NULL);// must not be in list pTemplate->LoadTemplate(); m_templateList.AddTail(pTemplate); } }
可以看出它主要的功能是m_templateList.AddTail(pTemplate),就是说把这个加入到他的内部变量 m_templateList中。简单的说,CDocManager::m_templateList拥有程序中所有的模板。上面提到的那一个 m_pDocManager 实际上是一个CWinApp的成员变量,在CWinApp的构造函数中初始化为NULL。实际上整个程序中也就是他拥有哪个模板的集合。
在仔细看一下CDocManager提供的函数,会发现很多熟悉的,如OnFileNew()等,实际CWinApp::OnFileNew和CWinApp::OnFileOpen都是通过调用CDocManager的对应函数实现的。如下:
void CWinApp::OnFileNew() { if (m_pDocManager != NULL) m_pDocManager->OnFileNew(); }
void CWinApp::OnFileOpen() { ASSERT(m_pDocManager != NULL); m_pDocManager->OnFileOpen(); }
说了这么多,那么CDocManager类到底发挥了什么作用的??正如前面所说,由于在CWinApp中有一个指向CDocManager对象的指针,而 CDocManager保存了程序中的所有模板,那就是说CDocManager是CWinApp和CDocTemplate沟通的桥梁。
总之:CWinApp对象有一个指向CDocManager对象的指针变量,而CDocManager对象中有一个指针链表来保存文档模板的指针(通过AddDocTemplate添加新的文档模板到这个指针),最后文档模板负责管理文档类、框架类、和视类一起来负责一个文档的操作。 注意:AddDocTemplate多个CDocTemplate对象指针的效果相当与vc6下,file->new下的多个文件类型选项,每种文件类型都有不同的doc、mainframe和view类对象。而CMultiDocTemplate的效果相当与word里面可以同时打开的文档1,文档2等等。CSingleDocTemplate的效果相当与记事本程序,一次只能有一个doc被打开。
补充(以下摘录自《深入浅出mfc》P347~348): 1、CWinApp拥有一个对象指针:CDocManager* m_pDocManager;; 2、CDocManager拥有一个指针链表 CPtrList m_templateList,用来维护一系列的Document Template; 3、CDocTemplate拥有三个成员变量,分别持有Document,View,Frame的CRumtimeClass指针(CRumtimeClass是每一个mfc类中描述该类属性的静态成员),另有一个成员变量m_nIDResource,用来表示此Document显现时采用的UI对象; 4、CDocument有一个成员变量,CDocTemplate* m_pDocTemplate回指其Document Template,另有一个成员变量CPtrList m_viewList,表示它可以同时维护一系列的view; 5、CFrameWnd有一个成员变量CView* m_pViewActive,指向当前活动的view; 6、CView有一个成员变量CDocument* m_pDocument,指向相关的Document。