2009-9-8

========================================================
《深入解析MFC》筆記 9.MFC的增強型用戶界面類
========================================================

----------------------------
CSplitterWnd： MFC分割窗口         《深入解析MFC》P249

    使用 CSplitterWnd
        創(chuàng)建動態(tài)分割窗口
        ① 在子框架的派生類中加上一個 CSplitterWnd 數(shù)據(jù)成員。
        ② 在CMyChildFrame::OnCreateClient() 處理程序，添加對 CSplitterWnd::Create() 的調(diào)用。
            Create() 的第一個參數(shù)指向父框架的指針，第二個和第三個分別指定了最大行數(shù)和最大列數(shù)。
                            第四個參數(shù)指定了所允許的最小窗格大小，第五個參數(shù)指向 CCreateContext 的指針。
        ③ 將框架窗口的 RUNTIME_CLASS 消息傳遞給 CDocTemplate 構(gòu)造函數(shù)：
            CMultiDocTemplate* pDocTemplate =
                new CMultiDocTemplate( IDR_MYAPPTYPE, RUNTIME_CLASS(CMyDocClass ), RUNTIME_CLASS( CMyChildFrameClass ),
                                  RUNTIME_CLASS（CMyViewClass））；
            AddDocTemplate（pDocTemplate）；

        創(chuàng)建靜態(tài)分割窗口，用 CreateStatic() 代替 Create()。調(diào)用CSplitterWnd::CreateView() 來創(chuàng)建新的窗格。
       
 *************************      
    CSplitterWnd 內(nèi)部實現(xiàn)
   
    封裝的數(shù)據(jù)類型
        · ESplitType —— 定義要畫出的分割器的類型，屬于枚舉類型。類型有 分割框、分割條、分割焦點以及分割邊界。
        · CRowColInfo —— 記錄行或列的最小尺寸、理想尺寸和當前尺寸。
    創(chuàng)建/布局數(shù)據(jù)成員
        · m_pDynamicViewClass —— 指向由 CSplitterWnd 動態(tài)創(chuàng)建的視圖（窗格）的CRuntimeClass 信息的指針。Create() 或CreateView()中定義
        · m_nMaxRows / m_nMaxCols —— 調(diào)用 Create() 和 CreateStatic() 時制定的最大行數(shù)和列數(shù)。
        · m_nRows / m_nCols —— 當前在 CSplitterWnd 里顯示的行數(shù)和列數(shù)。
        · m_bHasHScroll / m_bHasVScroll —— 表明行滾動條或列滾動條 是否已經(jīng)創(chuàng)建的標記。
        · m_pColInfo —— 是CRowInfo的數(shù)組，每個元素對應(yīng) CSplitterWnd 的一列。靜態(tài)分割中，這個值固定。
        · m_pRowInfo —— 是 CRowColInfo 的數(shù)組，每個元素對應(yīng)CSplitterWnd 的一行。
    修飾的數(shù)據(jù)成員
        在構(gòu)造函數(shù)中初始化，
        · m_cxSplitte / m_cySplitter —— 分割框和分割器的寬度和高度。
        · m_cxBorderShare / m_cyBorderShare —— 如果分割窗口正在畫分割窗口的邊界，值為1.
        · m_cxSplitterGap / m_cySplitterGap —— 分割框/分割條和滾動條/邊界之間的距離。值為6.
        · m_cxBorder / m_cyBorder —— 分割邊界的邊界寬度。值為0.
    跟蹤數(shù)據(jù)成員
        用于點擊測試和跟蹤
        · m_bTracking —— 如果為真，則用戶正在拖動一個分割條。
        · m_bTracking2 —— 如果為真，用戶正在拖動兩個分割條。
        · m_ptTrackOffset —— 點擊測試中的“選取”尺寸。允許用戶有所偏差。
        · m_rectLimit —— 跟蹤時窗格的大小，用來確定被跟蹤的分割條的高度。
        · m_rectTracker —— 跟蹤時用來畫分割條的矩形。
        · m_rectTracker2 —— 跟蹤時用來畫第二個分割條的矩形
        · m_htTrack —— 被 CSplitterWnd 的點擊跟蹤機制設(shè)置成一個枚舉值，用來描述分割窗口的哪個部分被點擊了。
    通用成員函數(shù)
        · CreateCommon() —— 當Create() 和 CreateStatic() 初始化完 CSplitterWnd 的動態(tài)成員或靜態(tài)成員時會調(diào)用這個函數(shù)。
        · CreateScrollBarCtrl() —— 創(chuàng)建帶有指定風(fēng)格和標示符的滾動條。
        · DoScroll() —— 對滾動條消息作出反應(yīng)。 DoScroll() 能夠同步適當?shù)拇案瘛?br>        · DoScrollBy() —— 以制定的數(shù)量滾動相應(yīng)的窗格。
        · DoKeyboardSplit() —— 在程序里調(diào)用該函數(shù)會使得窗口被分割。
        · CanActivateNext() —— 用來確定下一個窗格是否能被激活。即是否能得到焦點，被CView類調(diào)用
        · ActivateNext() —— 激活下一個窗格。通常在一個窗格被刪除時調(diào)用
    布局成員函數(shù)
        · RecalcLayout() —— 維護所有分割窗口的位置，當一個窗格被創(chuàng)建/刪除時，被調(diào)用。
        · TrackRowSize() —— 更新指定行的 m_pRowInfo 數(shù)組信息。同時確定是否有足夠的空間來存儲該行。
        · TrackColumnSize() ——
        · GetSizingParent() —— 搜索大小可變的父窗口
    繪畫成員函數(shù)
        · DrawAllSplitBars() —— “驅(qū)動”分割窗口的繪畫進程，為每個需要繪畫的組件調(diào)用 OnDrawSplitter.
        · OnDrawSplitter() —— 為分割窗口的每個組件進行繪畫，為虛函數(shù)。
        · OnPaint() —— 對WM_PAINT消息作出響應(yīng)
    點擊測試成員函數(shù)
        · HitTest() —— 選取某個點，返回這個點的點擊測試值。
        · GetInsideRect() —— 類同GetClientRect()，考慮了共享的滾動條。
        · GetHitRect() —— 為某一指定的分割窗口組件檢索點擊矩形。
        · SetSplitCursor() —— 使用點擊測試來確定要顯示哪一種光標。
    跟蹤成員函數(shù)
        · OnNcCreate() —— CSplitterWnd 處理WM_NCCREATE 消息，所以它可以移走 WS_EX_CLIENTEDGE 的擴展風(fēng)格位。
        · OnPaint() —— 畫分割窗口的各個組件。
        · OnDisplayChange() —— 當用戶改變顯示器的分辨率時背調(diào)用，調(diào)用RecalcLayout() 來更新分割窗口。
        · OnSize() —— 當用戶改變窗口大小時 調(diào)用 RecalcLayout()。
        · OnMouseMove() —— 在分割窗口組件上執(zhí)行點擊測試。
**************************
    CSplitteWnd 的初始化
        CSPlitterWnd::CreateCommon()
            ① 調(diào)整好風(fēng)格標記。
            ② 調(diào)用 AfxDeferRegisterClass()，CWnd::CreateEx()。
            ③ 為 m_pColInfo 和 m_pRowInfo 數(shù)組分配空間，并進行初始化，將 m_nMaxCols/Rows 作為數(shù)組的大小。
                CreateCommon() 在循環(huán)里一次訪問CRowColInfo數(shù)組，做如下操作
                    1. nMinSize 和 nIdealSize 都被設(shè)置成參數(shù) sizeMin的值。
                    2. nCurSize 被初始化為 -1，說明當窗格的尺寸被初始化（RecalcLayout）時，該值應(yīng)該被設(shè)置。
            ④ 初始化完CrowColInfo 的行列數(shù)組后，調(diào)用 SetScrollStyle() 將 m_bHasH/VScroll 進行初始化，然后返回TRUE
     
        CSplitterWnd::CreateView()
            ① 將sizeInit參數(shù)存儲在 CRowColInfo相應(yīng)的數(shù)組下標里，設(shè)置一個局部標記 bSendInitialUpdate 值為FALSE。
            ② 創(chuàng)建一個局部的CCreateContext(),盡量將每個元素初始化為比較完整的值。調(diào)用 GetActivePane() 來確定 m_pLastViewCView指針
                一旦CreateView() 有了m_pLastView，就可以通過調(diào)用 GetDocument() 來確定 CCreateContext 其他域的值，
                然后調(diào)用 CDocument::GetDocTemplate()。在找到所有這些元素后，pContext指向她們，將bSendInitialUpadte設(shè)為 TRUE。
            ③ 調(diào)用 CreateObject() 為 CRuntimeClass 信息創(chuàng)建一個窗格對象。設(shè)置要傳遞到 Create() 的參數(shù) 風(fēng)格和定位矩形。