关于CDocManager类

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的构造函数中初始化为ＮＵＬＬ。实际上整个程序中也就是他拥有哪个模板的集合。

　　在仔细看一下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沟通的桥梁。

 转贴：http://www.moon-soft.com/doc/49921.htm

总之：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。