CDockablePane的使用与注意

摘自网络，担心资源转移，特记录在此。

创建悬浮窗口的步骤：

1. 创建悬浮窗口类
每一个悬浮窗口都是一个CDockablePane的派生类的对象, 因此要为每一个悬浮窗口创建一个新类

1.1 添加类
通过菜单Project->Add Class...或者在类视图中工程名字处右键选择Add->Class...添加类
选择MFC Class, 点Add按钮进入下一步
Class name处写入新类的名字, 这里用CDock, 选择Base class为CDockablePane
按Finish按钮, 添加类完成.

1.2 添加消息处理函数
一般至少要处理两个消息, 一个是WM_CREATE, 一个是WM_SIZE, 具体步骤为:
(1) 头文件中添加函数声明(函数名及参数不可写错)
protected:
 afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);
 afx_msg void OnSize(UINT nType, int cx, int cy);
(2) cpp文件中添加消息映射
BEGIN_MESSAGE_MAP(CDock, CDockablePane)
 ON_WM_CREATE()
 ON_WM_SIZE()
END_MESSAGE_MAP()
这里BEGIN_MESSAGE_MAP和END_MESSAGE_MAP宏都是自动生成的, 只需要添加中间两行代码即可
(3) 添加函数实现部分
int CDock::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
 if (CDockablePane::OnCreate(lpCreateStruct) == -1)
  return -1;
 // 在这儿创建控件
 return 0;
}
void CDock::OnSize(UINT nType, int cx, int cy)
{
 CDockablePane::OnSize(nType, cx, cy);
 // 这儿添加代码
}

1.3 添加控件
现在创建的CDock类中由于没有任何控件, 因此如果现在创建该类的对象并显示, 该区域中由于全是垃圾数据, 故可能该窗口显示时为花屏. 如果程序运行期间出现类似花屏的问题, 大概会有几种可能性: 1. 没有创建控件 2. 已创建控件, 但控件位置不对或未覆盖整个的dockablePane 3. 控件虽然占据整个区域, 但不能自动刷新
这里以添加一个listBox为例:
(1) 在类的头文件中添加控件对象, 代码为:
protected:
 CListBox _listBox;
(2) 在OnCreate()中添加创建控件窗口的代码:
这里必须要注意, 需要先调用基类的函数OnCreate()
int CDock1::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
 if (CDockablePane::OnCreate(lpCreateStruct) == -1)
  return -1;

 // 在这儿创建控件
 // nID为该控件的ID, 可以自行设置, 如果对ID不感兴趣, 也可以选择传递0让系统做处理
 if (!_listBox.Create(WS_CHILD | WS_VISIBLE, CRect(0, 0, 0, 0), this, nID))
 {
  TRACE0("创建listbox失败");
  return -1;
 }

 return 0;
}
(3) 在OnSize中设置各个控件的位置
这里要注意的是, 需要将控件布满整个窗口. 这里只有一个listBox, 故可以直接用listBox覆盖窗口.
同理, 必须要先调用基类函数CDockablePane::OnSize(nType, cx, cy)
void CDock::OnSize(UINT nType, int cx, int cy)
{
 CDockablePane::OnSize(nType, cx, cy);
 // 这儿添加代码
 if (GetSafeHwnd() == NULL)
 {
  return;
 }

 if (_listBox.GetSafeHwnd() != NULL)
 {
  CRect rectClient;
  GetClientRect(rectClient);
  _listBox.SetWindowPos(NULL, rectClient.left, rectClient.top, rectClient.Width(), rectClient.Height(), SWP_NOACTIVATE | SWP_NOZORDER);
 }

}

 

2. 在程序中添加悬浮窗口对象
上面一步只是给工程添加了一个悬浮窗口类, 但并没生成该类的实例. 这里创建该实例(在CMainFrame类中)

2.1 在主框架类声明中添加对象, 代码为:
protected:  
 CDock m_wndDock;

2.2 创建dockablePane的窗口, 在主框架的OnCreate()函数中
(注: 这里我建议在OnCreate函数中自动生成代码EnableAutoHidePanes(CBRS_ALIGN_ANY)的后面添加)
int CMainFrame::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
 ...
 EnableAutoHidePanes(CBRS_ALIGN_ANY);
 // 利用这里的CBRS_RIGHT来设置最初的窗口停靠的位置, 可以的取值是
 // CBRS_NOALIGN, CBRS_LEFT, CBRS_TOP, CBRS_RIGHT, CBRS_BOTTOM
 DWORD style = WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS | WS_CLIPCHILDREN | CBRS_RIGHT | CBRS_FLOAT_MULTI;
 if (!wndDock1.Create(
  // 该dock窗口的标题(如果可以有的话...)
  _T("Dock1"),
  // 该dock窗口的parent, 设置为this
  this,
  //  窗口的大小, 注意是"悬浮"的情况下的大小, 处于dock状态时大小与该值无关
  CRect(0, 0, 200, 200),
  // 该dock窗口是否有标题, 如果为FALSE, 则第一个字符串参数显示不出来
  TRUE,
  // 该dock窗口的ID值. 注意: 如果希望dock窗口的状态可以保存在注册表中(这样下次启动程序时仍保持该状态),  则该值必须的唯一的
  nID,
  // 
  style))
 {
  return FALSE;
 }
 ...
} 

2.3去掉CDockablePane的Close按钮?

方法一:

在继承CDockablePane的类中重写CanBeClosed()方法: 

virtual BOOL CanBeClosed() const; ... BOOL COutputWnd::CanBeClosed() const { return FALSE;

}

方法二:

if (!m_wndView.Create(strFileView, this, CRect(0, 0, 250, 200), TRUE, ID_VIEW_VIEW,

  WS_CHILD | WS_VISIBLE | CBRS_LEFT | CBRS_HIDE_INPLACE | WS_CAPTION, AFX_CBRS_REGULAR_TABS, AFX_CBRS_RESIZE))在Create的时候 后面加上这样的参数设置AFX_CBRS_REGULAR_TABS, AFX_CBRS_RESIZE 就不会有那个关闭按钮了

2.4显示隐藏CDockablePane

m_wndFileView.ShowPane(TRUE,FALSE,TRUE);//显示

m_wndFileView.ShowPane(FALSE,FALSE,TRUE);//隐藏

2.5 给悬浮窗口添加icon, 暂时省略.

 

3. 设置窗口悬浮方式, 令窗口悬浮

3.1 设置窗口悬浮位置
这部分代码也应该在MainFrame类的OnCreate函数中, 而且紧跟创建悬浮窗口的后面.
设置悬浮位置只需要调用CDockablePane::EnableDocking即可
 m_wndDock.EnableDocking(CBRS_ALIGN_ANY);
其中, 参数可以是CBRS_ALIGN_TOP, CBRS_ALIGN_RIGHT, CBRS_ALIGN_BOTTOM, CBRS_ALIGN_ANY

3.2 令窗口悬浮
欲使一个CDockablePane对象悬浮, 只需要调用框架类的DockPane函数即可:
 DockPane(&m_wndDock);
但是若有另外一个悬浮窗口的对象需要和m_wndDock在一起显示, 构成一个组(就像VS的资源视力和类视图), 那么第二个悬浮窗口需要使用CDockablePane类的AttchToTabWnd函数, 代码如下:
 DockPane(&m_wndDock);
 CDockablePane *pTabbedBar = NULL;
 m_wndDock2.AttachToTabWnd(&m_wndDock, DM_SHOW, FALSE, &pTabbedBar);

 

 

CDockablePane 使用

这个是转载的

int m_nshowCurrent;

m_nshowCurrent=theApp.GetProfileInt(_T("Workspace//Pane-377"),_T("IsFloating"),0);  //在构造函数中

首先派生两个子类,源码就不用写出来了,占篇幅,在MainFrm里申明如:
CCurrentDockablePane         m_wndCurrentDockablePane;
CHistoryDockablePane        m_wndHistoryDockablePane;
CDockablePane* m_pTabbedBar;

然后在OnCreate()里面:
CString strHistoryDockablePane;
CString strCurrentView;
strCurrentView.LoadString(IDS_Current_VIEW);
strHistoryDockablePane.LoadString(IDS_History_VIEW);

if (!m_wndHistoryDockablePane.Create(strHistoryDockablePane, this, CRect(0, 0, 200, 200),
   TRUE, ID_VIEW_HistoryDockablePane, WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS | WS_CLIPCHILDREN | CBRS_LEFT | CBRS_FLOAT_MULTI))
{
     TRACE0("Failed to create Class View window/n");
      return FALSE; // failed to create
}

if (!m_wndCurrentDockablePane.Create(strCurrentView, this, CRect(0, 0, 200, 200),
   TRUE, ID_VIEW_CurrentView, WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS | WS_CLIPCHILDREN | CBRS_LEFT| CBRS_FLOAT_MULTI))
{
    TRACE0("Failed to create File View window/n");
     return FALSE; // failed to create
}

再给她们添加图标:
HICON hHistoryDockablePaneIcon = (HICON) ::LoadImage(::AfxGetResourceHandle(),
          MAKEINTRESOURCE(bHiColorIcons ? IDI_history : IDI_history), IMAGE_ICON, ::GetSystemMetrics(SM_CXSMICON), ::GetSystemMetrics(SM_CYSMICON), 0);
m_wndHistoryDockablePane.SetIcon(hHistoryDockablePaneIcon, FALSE);
HICON hCurrentViewIcon = (HICON) ::LoadImage(::AfxGetResourceHandle(),
   MAKEINTRESOURCE(bHiColorIcons ? IDI_Currrently : IDI_Currrently), IMAGE_ICON, ::GetSystemMetrics(SM_CXSMICON), ::GetSystemMetrics(SM_CYSMICON), 0);
m_wndCurrentDockablePane.SetIcon(hCurrentViewIcon, FALSE);

m_wndHistoryDockablePane.EnableDocking(CBRS_ALIGN_ANY);
m_wndCurrentDockablePane.EnableDocking(CBRS_ALIGN_ANY);

DockPane(&m_wndHistoryDockablePane);
DockPane(&m_wndCurrentDockablePane);
m_pTabbedBar = NULL;

m_wndCurrentDockablePane.AttachToTabWnd(&m_wndHistoryDockablePane, DM_SHOW, FALSE, &m_pTabbedBar);

相关显示代码就这样的了.后来老大说关闭需要修改工具栏里的显示状态,即去掉对勾.在工具栏里控制他们的显示和隐藏简单啊,就是用m_wndCurrentDockablePane.ShowPane(TRUE,FALSE,TRUE);可是关闭再去修改工具栏想了半天,以为要重载CDockablePane的Close()消息,又尝试了他的很多消息,都不对.跟踪进去才知道是调用MainFrm来关闭的.里面有pMainfrm.onCloseDockingPane(this);好了,我就重载这个方法.

BOOL CMainFrame::OnCloseDockingPane( CDockablePane* pWnd )
{
    CWnd * pfWnd = pWnd->GetFocus();
    if (*pfWnd == m_wndCurrentDockablePane)
    {
        m_nshowCurrent = 0;
    }
    else if(*pfWnd == m_wndHistoryDockablePane)
    {
       m_nshowHistory = 0;
    }
   return TRUE;
}
这样工具栏里面的信息就更新了.呵呵,高兴的太早了,才做了一半,当两个面板拆开,即处于浮动状态时关闭根本就不调用这里.又郁闷了半天,还是老大牛逼,说那种情况是OnCloseMiniFrame,于是有如下重载:

BOOL CMainFrame::OnCloseMiniFrame( CPaneFrameWnd* pWnd )
{
      CWnd *ptWnd = pWnd->GetWindow( GW_CHILD );
     if (*ptWnd ==m_wndCurrentDockablePane)
      {
            m_nshowCurrent = 0;
     }
      else if (*ptWnd == m_wndHistoryDockablePane)
    {
             m_nshowHistory = 0;
    }
   return TRUE;
}

 

//写注册表，在析构函数中

theApp.WriteProfileInt(_T("Workspace//Pane-377"),_T("IsFloating"),m_nshowCurrent);