VC++开发GIS系统（59）补充知识MFC中Ribbon界面新建一个停靠窗口（DockablePane）

在前一篇文章中我们在Ribbon界面中添加了Checkbox，用来控制工程管理面板的显示与隐藏。本文的任务是添加一个工程管理面板，效果如图：

具体方法如下。

1.复制文件

还记得在文章《VC++开发GIS系统（32）新建malagis的MFC工程》中我建议最好生成一个停靠窗口，本文就是要模仿系统自带的停靠窗口来实现一个自定义的停靠窗口。所以先复制系统自带的FileView.cpp和FileView.h文件，重命名为PrjManage.cpp和PrjManage.h。

2.创建一个新的类

修改PrjManage.cpp和PrjManage.h中的类命名，修改如下：

PrjManage.h

#pragma once

#include "ViewTree.h"

class CPrjManageToolBar : public CMFCToolBar
{
    virtual void OnUpdateCmdUI(CFrameWnd* /*pTarget*/, BOOL bDisableIfNoHndler)
    {
        CMFCToolBar::OnUpdateCmdUI((CFrameWnd*) GetOwner(), bDisableIfNoHndler);
    }

    virtual BOOL AllowShowOnList() const { return FALSE; }
};

class CPrjManage : public CDockablePane
{
// 构造
public:
    CPrjManage();

    void AdjustLayout();
    void OnChangeVisualStyle();

// 特性
protected:

    CViewTree m_wndFileView;
    CImageList m_FileViewImages;
    CPrjManageToolBar m_wndToolBar;

protected:
    void FillFileView();

// 实现
public:
    virtual ~CPrjManage();

protected:
    afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);
    afx_msg void OnSize(UINT nType, int cx, int cy);
    afx_msg void OnContextMenu(CWnd* pWnd, CPoint point);
    afx_msg void OnProperties();
    afx_msg void OnFileOpen();
    afx_msg void OnFileOpenWith();
    afx_msg void OnDummyCompile();
    afx_msg void OnEditCut();
    afx_msg void OnEditCopy();
    afx_msg void OnEditClear();
    afx_msg void OnPaint();
    afx_msg void OnSetFocus(CWnd* pOldWnd);

    DECLARE_MESSAGE_MAP()
};

PrjManage.cpp

#include "stdafx.h"
#include "mainfrm.h"
#include "PrjManage.h"
#include "Resource.h"
#include "malagis.h"

#ifdef _DEBUG
#undef THIS_FILE
static char THIS_FILE[]=__FILE__;
#define new DEBUG_NEW
#endif

/////////////////////////////////////////////////////////////////////////////
// CFileView

CPrjManage::CPrjManage()
{
}

CPrjManage::~CPrjManage()
{
}

BEGIN_MESSAGE_MAP(CPrjManage, CDockablePane)
    ON_WM_CREATE()
    ON_WM_SIZE()
    ON_WM_CONTEXTMENU()
    ON_COMMAND(ID_PROPERTIES, OnProperties)
    ON_COMMAND(ID_OPEN, OnFileOpen)
    ON_COMMAND(ID_OPEN_WITH, OnFileOpenWith)
    ON_COMMAND(ID_DUMMY_COMPILE, OnDummyCompile)
    ON_COMMAND(ID_EDIT_CUT, OnEditCut)
    ON_COMMAND(ID_EDIT_COPY, OnEditCopy)
    ON_COMMAND(ID_EDIT_CLEAR, OnEditClear)
    ON_WM_PAINT()
    ON_WM_SETFOCUS()
END_MESSAGE_MAP()

/////////////////////////////////////////////////////////////////////////////
// CWorkspaceBar 消息处理程序

int CPrjManage::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
    if (CDockablePane::OnCreate(lpCreateStruct) == -1)
        return -1;

    CRect rectDummy;
    rectDummy.SetRectEmpty();

    // 创建视图: 
    const DWORD dwViewStyle = WS_CHILD | WS_VISIBLE | TVS_HASLINES | TVS_LINESATROOT | TVS_HASBUTTONS;

    if (!m_wndFileView.Create(dwViewStyle, rectDummy, this, 4))
    {
        TRACE0("未能创建文件视图\n");
        return -1;      // 未能创建
    }

    // 加载视图图像: 
    m_FileViewImages.Create(IDB_FILE_VIEW, 16, 0, RGB(255, 0, 255));
    m_wndFileView.SetImageList(&m_FileViewImages, TVSIL_NORMAL);

    m_wndToolBar.Create(this, AFX_DEFAULT_TOOLBAR_STYLE, IDR_EXPLORER);
    m_wndToolBar.LoadToolBar(IDR_EXPLORER, 0, 0, TRUE /* 已锁定*/);

    OnChangeVisualStyle();

    m_wndToolBar.SetPaneStyle(m_wndToolBar.GetPaneStyle() | CBRS_TOOLTIPS | CBRS_FLYBY);

    m_wndToolBar.SetPaneStyle(m_wndToolBar.GetPaneStyle() & ~(CBRS_GRIPPER | CBRS_SIZE_DYNAMIC | CBRS_BORDER_TOP | CBRS_BORDER_BOTTOM | CBRS_BORDER_LEFT | CBRS_BORDER_RIGHT));

    m_wndToolBar.SetOwner(this);

    // 所有命令将通过此控件路由，而不是通过主框架路由: 
    m_wndToolBar.SetRouteCommandsViaFrame(FALSE);

    // 填入一些静态树视图数据(此处只需填入虚拟代码，而不是复杂的数据)
    FillFileView();
    AdjustLayout();

    return 0;
}

void CPrjManage::OnSize(UINT nType, int cx, int cy)
{
    CDockablePane::OnSize(nType, cx, cy);
    AdjustLayout();
}

void CPrjManage::FillFileView()
{
    HTREEITEM hRoot = m_wndFileView.InsertItem(_T("FakeApp 文件"), 0, 0);
    m_wndFileView.SetItemState(hRoot, TVIS_BOLD, TVIS_BOLD);

    HTREEITEM hSrc = m_wndFileView.InsertItem(_T("FakeApp 源文件"), 0, 0, hRoot);

    m_wndFileView.InsertItem(_T("FakeApp.cpp"), 1, 1, hSrc);
    m_wndFileView.InsertItem(_T("FakeApp.rc"), 1, 1, hSrc);
    m_wndFileView.InsertItem(_T("FakeAppDoc.cpp"), 1, 1, hSrc);
    m_wndFileView.InsertItem(_T("FakeAppView.cpp"), 1, 1, hSrc);
    m_wndFileView.InsertItem(_T("MainFrm.cpp"), 1, 1, hSrc);
    m_wndFileView.InsertItem(_T("StdAfx.cpp"), 1, 1, hSrc);

    HTREEITEM hInc = m_wndFileView.InsertItem(_T("FakeApp 头文件"), 0, 0, hRoot);

    m_wndFileView.InsertItem(_T("FakeApp.h"), 2, 2, hInc);
    m_wndFileView.InsertItem(_T("FakeAppDoc.h"), 2, 2, hInc);
    m_wndFileView.InsertItem(_T("FakeAppView.h"), 2, 2, hInc);
    m_wndFileView.InsertItem(_T("Resource.h"), 2, 2, hInc);
    m_wndFileView.InsertItem(_T("MainFrm.h"), 2, 2, hInc);
    m_wndFileView.InsertItem(_T("StdAfx.h"), 2, 2, hInc);

    HTREEITEM hRes = m_wndFileView.InsertItem(_T("FakeApp 资源文件"), 0, 0, hRoot);

    m_wndFileView.InsertItem(_T("FakeApp.ico"), 2, 2, hRes);
    m_wndFileView.InsertItem(_T("FakeApp.rc2"), 2, 2, hRes);
    m_wndFileView.InsertItem(_T("FakeAppDoc.ico"), 2, 2, hRes);
    m_wndFileView.InsertItem(_T("FakeToolbar.bmp"), 2, 2, hRes);

    m_wndFileView.Expand(hRoot, TVE_EXPAND);
    m_wndFileView.Expand(hSrc, TVE_EXPAND);
    m_wndFileView.Expand(hInc, TVE_EXPAND);
}

void CPrjManage::OnContextMenu(CWnd* pWnd, CPoint point)
{
    CTreeCtrl* pWndTree = (CTreeCtrl*) &m_wndFileView;
    ASSERT_VALID(pWndTree);

    if (pWnd != pWndTree)
    {
        CDockablePane::OnContextMenu(pWnd, point);
        return;
    }

    if (point != CPoint(-1, -1))
    {
        // 选择已单击的项: 
        CPoint ptTree = point;
        pWndTree->ScreenToClient(&ptTree);

        UINT flags = 0;
        HTREEITEM hTreeItem = pWndTree->HitTest(ptTree, &flags);
        if (hTreeItem != NULL)
        {
            pWndTree->SelectItem(hTreeItem);
        }
    }

    pWndTree->SetFocus();
    theApp.GetContextMenuManager()->ShowPopupMenu(IDR_POPUP_EXPLORER, point.x, point.y, this, TRUE);
}

void CPrjManage::AdjustLayout()
{
    if (GetSafeHwnd() == NULL)
    {
        return;
    }

    CRect rectClient;
    GetClientRect(rectClient);

    int cyTlb = m_wndToolBar.CalcFixedLayout(FALSE, TRUE).cy;

    m_wndToolBar.SetWindowPos(NULL, rectClient.left, rectClient.top, rectClient.Width(), cyTlb, SWP_NOACTIVATE | SWP_NOZORDER);
    m_wndFileView.SetWindowPos(NULL, rectClient.left + 1, rectClient.top + cyTlb + 1, rectClient.Width() - 2, rectClient.Height() - cyTlb - 2, SWP_NOACTIVATE | SWP_NOZORDER);
}

void CPrjManage::OnProperties()
{
    AfxMessageBox(_T("属性...."));

}

void CPrjManage::OnFileOpen()
{
    // TODO:  在此处添加命令处理程序代码
}

void CPrjManage::OnFileOpenWith()
{
    // TODO:  在此处添加命令处理程序代码
}

void CPrjManage::OnDummyCompile()
{
    // TODO:  在此处添加命令处理程序代码
}

void CPrjManage::OnEditCut()
{
    // TODO:  在此处添加命令处理程序代码
}

void CPrjManage::OnEditCopy()
{
    // TODO:  在此处添加命令处理程序代码
}

void CPrjManage::OnEditClear()
{
    // TODO:  在此处添加命令处理程序代码
}

void CPrjManage::OnPaint()
{
    CPaintDC dc(this); // 用于绘制的设备上下文

    CRect rectTree;
    m_wndFileView.GetWindowRect(rectTree);
    ScreenToClient(rectTree);

    rectTree.InflateRect(1, 1);
    dc.Draw3dRect(rectTree, ::GetSysColor(COLOR_3DSHADOW), ::GetSysColor(COLOR_3DSHADOW));
}

void CPrjManage::OnSetFocus(CWnd* pOldWnd)
{
    CDockablePane::OnSetFocus(pOldWnd);

    m_wndFileView.SetFocus();
}

void CPrjManage::OnChangeVisualStyle()
{
    m_wndToolBar.CleanUpLockedImages();
    m_wndToolBar.LoadBitmap(theApp.m_bHiColorIcons ? IDB_EXPLORER_24 : IDR_EXPLORER, 0, 0, TRUE /* 锁定*/);

    m_FileViewImages.DeleteImageList();

    UINT uiBmpId = theApp.m_bHiColorIcons ? IDB_FILE_VIEW_24 : IDB_FILE_VIEW;

    CBitmap bmp;
    if (!bmp.LoadBitmap(uiBmpId))
    {
        TRACE(_T("无法加载位图:  %x\n"), uiBmpId);
        ASSERT(FALSE);
        return;
    }

    BITMAP bmpObj;
    bmp.GetBitmap(&bmpObj);

    UINT nFlags = ILC_MASK;

    nFlags |= (theApp.m_bHiColorIcons) ? ILC_COLOR24 : ILC_COLOR4;

    m_FileViewImages.Create(16, bmpObj.bmHeight, nFlags, 0, 0);
    m_FileViewImages.Add(&bmp, RGB(255, 0, 255));

    m_wndFileView.SetImageList(&m_FileViewImages, TVSIL_NORMAL);
}

其实就是将原来的CFileView改为CPrjManage，相当于自定义了一个类。

3.MainFrm添加变量

在MainFrm.h中包含PrjManage.h头头文件。

#include "PrjManage.h"

在CMainFrame类中增加一个PrjManage对象。

CPrjManage        m_wndPrjManage;

在MainFrm.cpp中增加m_wndPrjManage相关函数，方法也很简单，就是将原来m_wndFileView相关的函数复制一份，替换成m_wndPrjManage。因为代码较多，可以查看我的代码：GitHub

4.删除原来文件

删除原来的无用的FileView.cpp和FileView.h还有ClassView.h和ClassView.cpp.

同时将MainFrm.h和MainFrm.cpp中文件关于m_wndFileView和m_wndClassView相关内容注释或者删除。