CSplitterWnd

CObject
 └CCmdTarget
    └CWnd
       └CSplitterWnd


CSplitterWnd类提供一个分隔器窗口的功能,分隔器窗口是一个包含有多个窗格的窗口。窗格通常是应用程序特定的由CView派生的对象,但它也可以是具有适当子窗口ID的任何CWnd对象。
一个CSplitterWnd对象通常被嵌入CFrameWnd或CMDIChildWnd父对象。你应按如下步骤创建一个CSplitterWnd对象:
1.在父框架中嵌入一个CSplitterWnd成员变量。
2.重载父框架的CFrameWnd::OnCreateClient成员函数。
3.从重载的OnCreateClient函数中调用类CSplitterWnd的Create或CreateStatic成员函数。
调用Create成员函数可以创建一个动态的分隔器窗口。动态的分隔器窗口通常用于创建和滚动同一文档的多个窗格或视。框架将自动为该分隔器创建一个起始窗格;然后,当用户操纵该分隔器窗口的控件时,框架创建,调整大小,并且排列其它的窗格。
当你调用Create时,应指定一个最小行高度和最小列宽度,这两个最小值被用来确定窗格什么时候太小以致于不能被完全显示。在调用了Create之后,你可以通过调用SetColumnInfo和SetRowInfo来调整这些最小值。
你还可以使用SetColumnInfo和SetRowInfo成员函数来给一列设置一个“理想的”宽度,以及给一行设置一个“理想的”高度。当框架显示一个分隔器窗口时,首先显示父框架,然后才显示分隔器窗口。然后,框架从分隔器窗口的客户区左上角至右下角,根据窗格的理想尺寸以行或列来排放各个窗格。
动态分隔器窗口中的所有窗格都必须是同一个类的窗格。读者熟悉的支持动态分隔器窗口的应用程序包括Microsoft Word和Microsoft Excel。
使用CreateStatic成员函数可以创建一个静态分隔器窗口。用户只能修改静态分隔器窗口中的窗格的尺寸,但是不能改变其中的窗格序号和次序。
在创建静态分隔器时必须专门创建该静态分隔器的所有窗格。你必须在父框架的OnCreateClient成员函数返回之前确保创建了所有窗格,否则,框架将不能正确显示该窗口。
CreateStatic成员函数将使用为0的最小行高度和最小列宽度来自动初始化一个静态分隔器。在调用了Create之后,可以通过调用SetColumnInfo和SetRowInfo成员函数来调整这两个最小值。在调用CreateStatic之后,你也可以使用SetColumnInfo和SetRowInfo成员函数来指定你所希望的理想窗格值。
静态分隔器中的窗格通常属于不同的类。给予静态分隔器窗口的示例,参见图形编辑器和Windows文件管理器。分隔器窗口支持特殊的滚动条(除窗格可能带有的滚动框之外)。这些滚动条是CSplitterWnd对象的子对象并且被窗格共享。
当你创建这个分隔器窗口时,你创建了这些特殊的滚动条。例如,如果一个CSplitterWnd具有一行,两列,则WS_VSCROLL风格将显示两个窗格共享的垂直滚动条。当用户移动这个滚动条时,WM_VSCROLL消息将被发送给两个窗格。当窗格设置滚动条位置时,这个共享滚动条将被设置。
有关动态分隔器窗口的更多信息,参见“Visual C++程序员指南”中的文章“多文档类型,视和框架窗口”中的“分隔器窗口”;和Visual C++联机文档中的“TN029:分隔器窗口”;以及CSplitterWnd类概述。有关如何创建动态分隔器窗口的更多信息,参见“Visual C++联机教程”中的“在增强视的Scribble中添加分隔器窗口”;和MFC常规示例VIEWEX。
#include <afxext.h>
请参阅:CView, CWnd

CSplitterWnd类成员

构造
CSplitterWnd构造一个CSplitterWnd对象
Create创建一个动态的分隔器窗口并将它与一个CSplitterWnd对象连接
CreateStatic创建一个静态的分隔器窗口并将它与一个CSplitterWnd对象连接
CreateView在一个分隔器窗口中创建一个窗格

操作符
GetRowCount返回当前窗格行的计数值
GetColumnCount返回当前窗格列的计数值
GetRowInfo返回指定行的信息
SetRowInfo设置指定行的信息
GetColumnInfo返回指定列的信息
SetColumnInfo设置指定列的信息
GetPane返回位于指定行和列处的窗格
IsChildPane确定窗口是否是此分隔器窗口的当前子窗格
IdFromRowCol返回位于指定行和列处的窗格的子窗口ID
RecalcLayout在调整行或列尺寸后调用此函数来重新显示该分隔器窗口
GetScrollStyle返回共享滚动条的风格
SetScrollStyle为分隔器窗口的共享滚动条指定新的滚动条风格

可重载
OnDrawSplitter绘制一个分隔器窗口的图像
OnInvertTracker绘制一个分隔器窗口的图像,使它具有与框架窗口相同的大小和形状
CreateScrollBarCtrl创建一个共享的滚动条控件
DeleteView从分隔器窗口中删除一个视图
SplitRow表明一个框架窗口是否是水平分隔的
SplitColumn表明一个框架窗口是否是垂直分隔的
DeleteRow从分隔器窗口中删除一行
DeleteColumn从分隔器窗口中删除一列
GetActivePane根据焦点或框架中的活动视来确定活动窗格
SetActivePane在框架中设置一个活动窗格
CanActivateNext检查Next Pane或Previous Pane命令当前是否有效
ActivateNext执行Next Pane或Previous Pane命令
DoKeyboardSplit执行键盘分隔命令,通常是“Window Split”
DoScroll执行分隔窗口的同步滚动
DoScrollBy将分隔窗口滚动给定的像素数