切分窗口学习总结及实例

　　最近尝试了一下在VC6下的切分窗口，在这里做个总结。

一、引用

　　当用户需要同时对文当的不同部分进行编辑时，常常会用到切分窗口;这些窗口可以都是相同的视图，或者一个窗口为列表视，而另一个为树型视图。应用程序框架有多种方式来表示多视图，切分窗口是其中的方式之一。

　　切分窗口分为动态切分窗口和静态切分窗口，它们都是由CSplitterWnd类(MFC类库)来实现的，在这两种表示方式中，创建同一视图类的对象是比较容易的(Cview)，而在同一应用程序使用两个或更多的视图类(如:ClistView、CtreeView等)，相对来说则要困难一些。

　　动态切分功能多应用在编辑文本类的软件中，在实际的开发中，我们经常要用到的是静态切分功能。静态切分窗口是指在窗口创建时，切分窗口的窗格就已经创建好了，且窗格的数量和顺序不会改变，窗格为一个分隔条所分隔，用户可以拖动分隔条调整相应窗格的大小。静态切分窗口最多支持16行´16列的窗格，而且不同的窗格往往使用不同的视图类。本文主要阐述静态切分窗口。

二、关于CSplitterWnd类
　　要想切分窗口，我们就要先来熟悉下CSplitterWnd类。我们在使用CuteFtp或者NetAnt等工具的时候，一般都会被其复杂的界面所吸引，在这些界面中窗口被分割为若干的区域，真正做到了窗口的任意分割。 那么我们自己如何创建类似的界面，也实现窗口的任意的分割呢 ？在VC6.0中这就需要使用到CSplitterWnd类。CSplitterWnd看上去像是一种特殊的框架窗口，每个窗口都被相同的或者不同的视图所填充。当窗口被切分后用户可以使用鼠标移动切分条来调整窗口的相对尺寸。虽然VC6.0支持从AppWizard中创建分割窗口，但是自动加入的分割条总是不能让我们满意，因此我们还是通过手工增加代码来熟悉这个类。 
CSplitterWnd的构造函数主要包括下面三个。 

 

BOOL Create(CWnd* pParentWnd,int nMaxRows,int nMaxCols,SIZE sizeMin,CCreateContext* pContext,DWORD dwStyle,UINT nID);

功能描述：该函数用来创建动态切分窗口。 参数含义：pParentWnd 切分窗口的父框架窗口。 nMaxRows,nMaxCols是创建的最大的列数和行数。 sizeMin是窗格的现实大小。 pContext 大多数情况下传给父窗口。 nID是字窗口的ID号.

BOOL CreateStatic(CWnd* pParentWnd,int nRows,int nCols,DWORD dwStyle,UINT nID) 

　

功能描述：用来创建切分窗口。 参数含义同上。

BOOL CreateView (int row,int col,CruntimeClass* pViewClass,SIZE sizeinit,CcreateContext* pContext);

功能描述：为静态切分的窗口的网格填充视图。在将视图于切分窗口联系在一起的时候必 须先将切分窗口创建好。 

参数含义：同上。

从CSplitterWnd源程序可以看出不管是使用动态创建Create还是使用静态创建CreateStatic，在函数中都调用了一个保护函数CreateCommon，从下面的CreateCommon函数中的关键代码可以看出创建CSplitterWnd的实质是创建了一系列的MDI子窗口。 

DWORD dwCreateStyle = dwStyle & ~(WS_HSCROLL|WS_VSCROLL);
if (afxData.bWin4) 
       dwCreateStyle &= ~WS_BORDER; //create with the same wnd-class as MDI-Frame (no erase bkgnd) 
if (!CreateEx(0, _afxWndMDIFrame, NULL, dwCreateStyle, 
          0, 0, 0, 0,pParentWnd->m_hWnd, (HMENU)nID, NULL)) 
return FALSE; // create invisible 

　　

在这里要注意的是，用CreateStatic创建了一个静态窗格后，要用CreateView填充窗格才能显示。

二、实例

　　以单文档SDI应用程序为例，在框架客户区实现三叉切分窗口，且每个窗格使用不同的视图 。

　　实现步骤:

　　1、 利用VC++6.0 的AppWizard创建一个单文档SDI应用程序，项目名为TestFrame。

　　2、 创建一个对话模板资源，ID为IDD_FORMVIEW.

　　使用New Class对话框添加新的视图类:

　　CinfoView 基类为列表视图类ClistView

　　CLineView 基类为表单视图类CFormView

　　CMyEditView 基类为编辑视图类CEditView

　　要点:在添加ClineView之前，需要先创建一个ID为IDD_FORMVIEW对话模板资源.

　　如果添加类之后编译出现：“error C2504: 'CListView' : base class undefined”错误，

　　则在类的头文件或stdafx.h中加入: #include <afxcview.h>

　　3、 在框架窗口类CMainFrame中声明一个CSplitterWnd类的成员变量m_wndSplitter1，用于第一次切分。

　　4、 使用ClassWizard为框架窗口类添加OnCreateClient函数。

　　注意:OnCreateClient函数的调用在OnCreate函数之后，在构造视图对象和产生视图窗口之前。

　　5、 在OnCreateClient函数中调用CSplitterWnd::CreateStatic，产生静态切分。该函数的原形如下:

　　BOOL CreateStatic( CWnd* pParentWnd, int nRows, int nCols, DWORD dwStyle =

　　WS_CHILD | WS_VISIBLE, UINT nID = AFX_IDW_PANE_FIRST );

　　函数有5个参数，意义如下:

　　● pParentWnd:切分窗口的父窗口指针

　　● nRows:水平方向分隔窗口的数目

　　● nCols:垂直方向分隔窗口的数目

　　● dwStyle:切分窗口的风格

　　● nID:子窗口的ID值，默认为系统定义的AFX_IDW_PANE_FIRST

　　返回值:如果创建成功，返回非零值(TRUE)，否则返回0(FALSE)。

　　m_wndSplitter1.CreateStatic(this, 2,1); // 切分为2行1列

　　6、 使用CreateView产生每个视图窗口

　　virtual BOOL CreateView( int row, int col, CRuntimeClass* pViewClass, SIZE sizeInit, CCreateContext* pContext );

　　函数有5个参数，意义如下:

　　● row:窗格的行标，从0开始

　　● col:窗格的列标，从0开始

　　● pViewClass:视图的执行期类CRuntimeClass指针，可以用宏RUNTIME_CLASS获得

　　● sizeInit:一个SIZE(或者CSize)类型的数据，指定窗格的初始大小

　　● pContext:一般是由父窗口传递过来，包含窗口的创建信息

　　返回值:如果创建成功，返回非零值(TRUE)，否则返回0(FALSE)。

　　OnCreateClient函数的全部代码:

　　

BOOL CMainFrame::OnCreateClient(LPCREATESTRUCT lpcs, CCreateContext* pContext) 
{
　　// TODO: Add your specialized code here and/or call the base class

　　CRect rect;
　　GetClientRect(&rect);

　　//产生第一次静态切分
　　m_wndSplitter1.CreateStatic(this, 2, 1);

　　//为第0行第0个窗格产生视图
　　m_wndSplitter1.CreateView(0, 0, RUNTIME_CLASS(CTestFrameView), CSize(rect.Width(),rect.Height() - rect.Height()/4), pContext);

　　//为第1行第0个窗格产生视图
　　m_wndSplitter1.CreateView(1, 0, RUNTIME_CLASS(CMyEditView), CSize(rect.Width(), rect.Height()/4), pContext);

　　return TRUE;//不再调用基类的OnCreateClient函数
　　//return CFrameWnd::OnCreateClient(lpcs, pContext); 
}

　

在这里需注意3点:

　　① 必须为每个静态切分窗格创建视图窗口，不能漏掉一个;

　　② 必须包含相应的类的头文件，在MainFrm.cpp文件的开始包含一下头文件:

　　#include "TestFrameView.h"

　　#include "MyEditView.h"

　　③产生静态切分后，就不能调用默认的基类的OnCreateClient函数。

在这里会出现一个“error C2143: syntax error : missing ';' before '*'”的错误，解决方法在这里：http://blog.csdn.net/weuro/article/details/7224752   即剪切TestFrameView.cpp中的“#include "TestFrameDoc.h" ”，这行语句，并将其粘贴到TestFrameView.h文件的前部。

 

　　7、 在视图窗口类CTestFrameView中声明一个CSplitterWnd类的成员变量m_wndSplitter2，用于第二次切分。

　　8、 使用ClassWizard为视图窗口类CTestFrameView添加OnCreate函数，在该函数中调用CreateStatic函数和CreateView函数,类似CMainFrame::OnCreateClient函数中的调用

　　代码如下:

int CTestFrameView::OnCreate(LPCREATESTRUCT lpCreateStruct) 
{
    if (CView::OnCreate(lpCreateStruct) == -1)
        return -1;
    // TODO: Add your specialized creation code here 
 
    CRect rect;  
    GetClientRect(&rect);  

    //获得窗口的创建信息指针  
    CCreateContext *pContext = (CCreateContext*) lpCreateStruct->lpCreateParams;  

    //产生二次静态切分，将TestFrame切分为1行2列
    m_wndSplitter2.CreateStatic(this,1, 2);  

    //为第0行第0列窗格产生视图
    m_wndSplitter2.CreateView(0,0, RUNTIME_CLASS(CLineView), CSize(rect.Width()/4, rect.Height()),  pContext); 

    //为第0行第1列窗格产生视图  
    m_wndSplitter2.CreateView(0,1, RUNTIME_CLASS(CinfoView), CSize(rect.Width() - rect.Width()/4, rect.Height()),  pContext);
    
    return 0;
}

　　

注意:二次切分的父窗口是第一次切分的第一个窗格，其视图类是CTestFrameView，这时候窗格并不会显示，我们还要再添加个OnSize函数。附带说下，文章开头说了切分的窗口可以都是相同的视图，也可以是不同的视图，创建同一视图类的对象是比较容易的(Cview)，而在同一应用程序使用两个或更多的视图类(如:ClistView、CtreeView等)，相对来说则要困难一些。本例是创建三个视图类，如果创建的是相同的视图类，可以直接在OnCreateClient中进行二次的分割和填充。

　　9、使用ClassWizard为视图窗口类CTestFrameView添加OnSize函数

　　代码如下:

void CTestFrameView::OnSize(UINT nType, int cx, int cy) 
{
　　CView::OnSize(nType, cx, cy);

　　// TODO: Add your message handler code here

　　CRect rect; 
　　GetClientRect(&rect); 
　　cx = rect.Width(); 
　　cy = rect.Height(); 
　　m_wndSplitter2.MoveWindow(-2, -2, cx, cy + 3); 
　　m_wndSplitter2.SetColumnInfo(0, cx/4, 0); 
　　m_wndSplitter2.SetColumnInfo(1, cx - cx/4, 0); 
　　m_wndSplitter2.RecalcLayout();
}

　　

　　该函数主要用于设置二次切分后的各列信息，通过CSplitterWnd::SetColumnInfo函数实现，原型为:void SetColumnInfo( int col, int cxIdeal, int cxMin );

　　由3 个参数，意义如下:

　　● col:切分窗口的列标识

　　● cxIdeal:列的实际宽度，单位为像素

　　● cxMin:列的最小宽度，单位为像素

　　本示例的运行结果如下:

　　三、总结

　　切分窗口的形式和每个窗格所使用的视图类可以根据实际需要来确定，以满足程序的不同应用。本示例使用了三叉切分，视图类使用了列表视图类CListView、表单视图类CFormView、编辑视图类CEditView，在VC++6.0下调试通过。

　　三叉切分的方法并不唯一，本文实例是我在实际开发中总结的一种方法，读者可以通过本例举一反三，掌握切分窗口与多视图相结合的精髓所在。这篇随笔只是本人对切分窗口的一个总结，如有不当之处，请不吝指出，非常感谢。

本文来自博客园，其中例子来自http://blog.csdn.net/mxling/article/details/4727867，转载请注明出处：http://www.cnblogs.com/GWeuro/archive/2012/02/01/2334150.html