CSplitter W nd

CSplitterWnd 类提供一个分隔器窗口的功能，分隔器窗口是一个包含有多个窗格的窗口。窗格通常是应用程序特定的由 CView 派生的对象，但它也可以是具有适当子窗口 ID 的任何 CWnd 对象。

个 CSplitterWnd 对象通常被嵌入 CFrameWnd 或 CMDIChi ld Wnd 父
对象。你

应按如下步骤创建一个 CSplitterWnd 对象：

在父框架中嵌入一个 CSplitterWnd 成员变量。
重载父框架的 CFrameWnd:: OnCreateClient 成员函数。
从重载的 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 成员函数来指定你所希望的理想窗格值。

静态分隔器中的窗格通常属于不同的类。给予静态分隔器窗口的示例，参见图形编辑器和 W indows 文件管理器。分隔器窗口支持特殊的滚动条（除窗格可能带有的滚动框之外）。这些滚动条是 CSplitterWnd 对象的子对象并且被窗格共享。

当你创建这个分隔器窗口时，你创建了这些特殊的滚动条。例如，如果一个CSplitterWnd 具有一行，两列，则 WS_VSCROLL 风格将显示两个窗格共享的垂直滚动条。当用户移动这个滚动条时， WM_VSCROLL 消息将被发送给两个窗格。当窗格设置滚动条位置时，这个共享滚动条将被设置。

有关动态分隔器窗口的更多信息，参见“ V isual C++ 程序员指南 ” 中的文章 “ 多文档类型，视和框架窗口 ” 中的 “ 分隔器窗口 ” ；和 Visual C++ 联机文档中的“ TN029 ：分隔器窗口 ” ；以及 CSplitterWnd 类概述。有关如何创建动态分隔器窗口的更多信息，参见 “ Visual C++ 联机教程 ” 中的 “ 在增强视的 Scribble 中添加分隔器窗口 ” ；和 MFC 常规示例 V IEWEX 。

#include <afxext.h>

请参阅 CView ， CWnd

CSplitterWnd 类成员

Construction

CsplitterWnd 构造一个 CSplitterWnd 对象

Create 创建一个动态的分隔器窗口并将它与一个

CSplitterWnd 对象连接

CreateStatic 创建一个静态的分隔器窗口并将它与一个

CSplitterWnd 对象连接

CreateView 在一个分隔器窗口中创建一个窗格

Operation s GetRowCount 返回当前窗格行的计数值

GetColumnCount 返回当前窗格列的计数值

GetRowInfo 返回指定行的信息

SetRowInfo 设置指定行的信息

GetColumnInfo 返回指定列的信息

SetColumnInfo 设置指定列的信息

GetPane 返回位于指定行和列处的窗格

IsChildPane 确定窗口是否是此分隔器窗口的当前子窗格IdFromRowCol 返回位于指定行和列处的窗格的子窗口 ID RecalcLayout 在调整行或列尺寸后调用此函数来重新显示该分

隔器窗口

GetScrollStyle 返回共享滚动条的风格

SetScrollStyle 为分隔器窗口的共享滚动条指定新的滚动条风格

Overridables

OnDrawSplitter 绘制一个分隔器窗口的图像

OnInvertTracker 绘制一个分隔器窗口的图像，使它具有与框架窗

口相同的大小和形状CreateScrollBarCtrl 创建一个共享的滚动条控件DeleteView 从分隔器窗口中删除一个视

SplitRow 表明一个框架窗口是否是水平分隔的

SplitColumn 表明一个框架窗口是否是垂直分隔的

DeleteRow 从分隔器窗口中删除一行

DeleteColumn 从分隔器窗口中删除一列

GetActivePane 根据焦点或框架中的活动视来确定活动窗格

SetActivePane 在框架中设置一个活动窗格

CanActivateNext 检查 Next Pane 或 Previous Pane 命令当前是否有

效

ActivateNext 执行 Next Pane 或 Previous Pane 命令

DoKeyboardSplit 执行键盘分隔命令，通常是 “ Window S plit ”

DoScroll 执行分隔窗口的同步滚动

DoScrollBy 将分隔窗口滚动给定的像素数

成员函数

CSplitter W nd::ActivateNext

virtual void ActivateNext( BOOL bPrev = FALSE );

参数

bPrev

表明要激活哪一个窗口。 TRUE 表示激活前一个窗口， FALSE 表示激活下一个窗口。

框架调用此成员函数来执行 Next Pane 或 Previous Pane 命令。

这个成员函数是一个高级命令，它由 CView 类用来作为 CSplitterWnd 实现的代表。

请参阅 CView, CSplitterWnd::CanActivateNext, CSplitterWnd::SetActivePane

CSplitter W nd::CanActivateNext

virtual BOOL CanActivateNext( BOOL bPrev = FALSE );

返回值

如果成功则返回非零值；否则返回 0 。

bPrev

表明要激活哪一个窗口。 TRUE 表示激活前一个窗口， FALSE 表示激活下一个窗口。

说明

框架调用此成员函数来检查 Next Pane 和 Previous Pane 命令当前是否有效。

这个成员函数是一个高级命令，它由 CView 类用来作为 CSplitterWnd 实现的代表。

请参阅 CSplitterWnd::ActivateNext, CSplitterWnd::SetActivePane

CSplitter W nd::Create

BOOL Create( CWnd* pParentWnd , int nMaxRow s , int nMaxCols , SIZE sizeMin , CCreateContext* pContext , DWORD dwStyle = WS_CHILD | WS_VISIBLE

|WS_HSCROLL | WS_VSCROLL | SPLS_DYNAMIC_SPLIT, UINT nID = AFX_IDW_

PANE_FIRST );

返回值

如果成功则返回非零值；否则返回 0 。

参数

pParentWnd

分隔器窗口的父框架窗口。

nMaxRows

分隔器窗口中的最大行数。这个值不能超过 2 。

nMaxCols

分隔器窗口中的最大列数。这个值不能超过 2 。

sizeMin

指出显示一个窗格所需的最小尺寸。

pContext

指向一个 CCreateContext 结构的指针。多数情况下，这个值可以是传递给父框架窗口的 pContex t。

dwStyle

指定窗口的风格。

nID

此窗口的子窗口 ID 。如果这个分隔器窗口不是嵌套在另一个分隔器窗口中的，则这个 ID 可以是 AFX_IDW_PANE_FIRST 。

说明

要创建一个动态分隔器窗口，应调用 Create 成员函数。

你可以通过如下步骤将一个 CSplitterWnd 嵌入一个 CFrameWnd 或

C M D IChildWnd 父对象：

在父框架中嵌入一个 CSplitterWnd 成员变量。
重载父框架的 CFrameWnd::OnCreateClient 成员函数。
从重载的 OnCreateClient 中调用 Create 成员函数。

当你从一个父框架内创建一个分隔器窗口时，将父框架的 pContext 参数传递给此分隔器窗口。否则， Create 函数的 pContext 可以是 NULL 。

个动态分隔器窗口的初始最小行高度和列宽度由 size
M in 参数设置。这些最小值被用来确定窗格是否太小以至于不能将其完整地显示出来。

有关动态分隔器窗口的更多信息，参见“ V isual C++ 程序员指南 ” 中的文章 “ 多文档类型，视，和框架窗口 ” 中的 “ 分隔器窗口 ” ； “ Visual C++ 联机文档 ” 中的 “ TN029 ：分隔器窗口 ” ；以及 CSplitterWnd 类概述。

请参阅 CSplitterWnd::CreateStatic, CFrameWnd::OnCreateClient,

CSplitterWnd::SetRowInfo, CSplitterWnd::SetColumnInfo, CSplitterWnd::CreateView

CSplitter W nd::CreateScrollBarCtrl

virtual BOOL CreateScrollBarCtrl( DWORD dwStyle , UINT nID );

返回值

如果成功则返回非零值；否则返回 0 。

参数

dwStyle

指定窗口的风格。

nID

此窗口的子窗口 ID 。如果这个分隔器窗口不是嵌套在另一个分隔器窗口中的，则这个 ID 可以是 AFX_IDW_PANE_FIRST 。

说明

框架调用此成员函数来创建一个共享的滚动条控件。重载 CreateScrollBarCtrl 来包括一个滚动条附近的其它控件。缺省的行为是创建标准的 Windows 滚动条控件。

请参阅 AfxGetInstanceHandle

CSplitter W nd::CreateStatic

BOOL CreateStatic( CWnd* pParentWnd, int nRows, int nCols,

DWORD dwStyle = WS_CHILD | WS_VISIBLE, UINT nID = AFX_IDW_PANE_FIRST );

返回值

如果成功则返回非零值；否则返回 0 。

参数

pParentWnd

分隔器窗口的父框架窗口。

nRows

行数。这个值必须不超过 16 。

nCols

列数。这个值必须不超过 16 。

dwStyle

指定窗口的风格。

nID

此窗口的子窗口 ID 。如果这个分隔器窗口不是嵌套在另一个分隔器窗口中的，则这个 ID 可以是 AFX_IDW_PANE_FIRSH 。

说明

要创建一个静态的分隔器窗口，应调用 CReateStatic 成员函数。

你可以通过如下步骤将一个 CSplitterWnd 嵌入一个 CFrameWnd 或

C M D IChildWnd 父对象：

在父框架中嵌入一个 CSplitterWnd 成员变量。
重载父框架的 CFrameWnd::OnCreateClient 成员函数。
从重载的 OnCreateClient 中调用 Create 成员函数。

个静态的分隔器窗口包含了固定数目的窗格，这些窗
格是不同类的。

当你创建一个静态分隔器窗口时，你必须同时创建它的所有窗格。 CReateView

成员函数通常就是用于这个目的，但你也可以创建其它非视类。

个静态分隔器窗口的初始最小行高度和列高度是 0 。
这些最小值用来确定窗格是否太小以至于不能将其完整地显示出来。

要给静态分隔器窗口添加滚动条，就应在 dwStyle 参数中指定 WS_HSCROLL

或 WS_VSCROLL 风格。

有关静态分隔器窗口的更多信息，参见“ V isual C++ 程序员指南 ” 中的文章 “ 多文档类型，视，和框架窗口 ” 中的 “ 分隔器窗口 ” ； “ Visual C++ 联机文档 ” 中的 “ TN029 ：分隔器窗口 ” ；以及 CSplitterWnd 类概述。

请参阅 CSplitterWnd::Create, CFrameWnd::OnCreateClient,

CSplitterWnd::SetRowInfo,

CSplitterWnd::SetColumnInfo, CSplitterWnd::CreateView

CSplitter W nd::CreateView

virtual BOOL CreateView( int row , int co l, CRuntimeClass* pViewClass , SIZE

sizeInit,

CCreateContext* pContext );

返回值

如果成功则返回非零值；否则返回 0 。

参数

row

指定用来放置新视的分隔器窗口行。

col

指定用来放置新视的分隔器窗口列。

pViewClass

指定新视的 CRuntimeClass。

sizeInit

指定新视的初始尺寸。

pContext

指向用来创建此视的创建环境的指针（通常，该 pContext 被传递给在其中创建此分隔器窗口的父框架的重载的 OnCreateClient 成员函数）。

说明

此成员函数用来为一个静态分隔器窗口创建窗格。一个静态分隔器窗口的所有窗格必须在框架显示这个分隔器之前被创建。

当一个动态分隔器的用户分隔一个窗格，行或列时，框架也调用这个成员函数来创建新的窗格。

请参阅 CSplitterWnd::Create

CSplitter W nd::CSplitter W nd

CSplitterWnd( );

说明

构造一个 CSplitterWnd 分两步。首先调用这个构造函数，它创建一个CSplitterWnd 对象，然后调用 Create 成员函数来创建分隔器窗口并将它与该CSplitterWnd 对象连接。

请参阅 CSplitterWnd::Create

CSplitter W nd::DeleteColumn

virtual void DeleteColumn( int colDelete );

参数

colDelete

指定要被删除的列。

说明

当要删除一个列时调用此成员函数。

框架调用此成员函数来实现动态分隔器窗口的逻辑（如果此分隔器窗口具有SPLS_DYNAMIC_SPLIT 风格）。它可以用虚函数 CreateView 来定制，以实现更高级的动态分隔器。

请参阅 CSplitterWnd::DeleteRow, CSplitterWnd::CreateView, CSplitterWnd::DeleteView

CSplitter W nd::DeleteRow

virtual void DeleteRow( int rowDelete );

参数

rowDelete

指定要被删除的行。

说明

当要删除一个行时调用此成员函数。

框架调用此成员函数来实现动态分隔器窗口的逻辑（如果此分隔器窗口具有SPLS_ DYNAMIC_SPLIT 风格）。它可以用虚函数 CreateView 来定制，以实现更高级的动态分隔器。

请参阅 CSplitterWnd::DeleteColumn, CSplitterWnd::CreateView,

CSplitterWnd::DeleteView

CSplitter W nd::DeleteView

virtual void DeleteView( int row , int col );

参数

row

指定要在分隔器窗口的哪一行中删除视。

col

指定要在分隔器窗口的哪一列中删除视。

说明

当要删除一个视时调用 DeleteView 。如果删除的是活动视，则下一个将成为活动视。缺省的实现假定这个视将在 PostNcDestroy 中自动删除。

请参阅 CWnd::PostNcDestroy, CSplitterWnd::CreateView,

CSplitterWnd::DeleteColumn,

CSplitterWnd::DeleteRow CSplitter W nd::DoKeyboardSplit virtual BOOL DoKeyboardSplit( ); 返回值

如果成功则返回非零值；否则返回 0 。

框架调用此成员函数来实现一个键盘分隔命令，通常是 W indow Split 。

这个成员函数是一个高级命令，被 CView 用来作为 CSplitterWnd 实现的代表。

请参阅 CView

CSplitter W nd::DoScroll

virtual BOOL DoScroll( CView* pViewFrom , UINT nScrollCode ,BOOL bDoScroll

= TRUE );

返回值

如果发生了同步的滚动则返回非零值；否则返回 0 。

pViewFrom

个指向视的指针，滚动消息就是从这个视中发出的。

nScrollCode

一个滚动条代码，它表明了用户的滚动要求。这个参数包括两个部分：一个是低字节，用来确定发生的水平滚动的类型，一个是高字节，用来确定发生的垂直滚动的类型：

SB_BOTTOM 滚动到底。
SB_LINEDOWN 向下滚动一行。
SB_LINEUP 向上滚动一行。
SB_PAGEDOWN 向下滚动一页。
SB_PAGEUP 向上滚动一页。
SB_TOP 滚动到顶。

bDoScroll

确定是否可以发生指定的滚动动作。如果 bDoScroll 是 TRUE （就是说，如果一个子窗口存在，并且此分隔窗口有一个滚动范围），则指定的滚动动作可以发生；如果 bDoScroll 是 FALSE （就是说，如果不存在一个子窗口，或此分隔视没有滚动范围），则滚动将不会发生。

说明

当视接收到一个滚动消息时，框架调用此成员函数来执行分隔窗口的同步滚动。

重载这个函数，在同步滚动允许之前请求一个由用户指定的动作。

请参阅 CSplitterWnd::DoScrollBy, CView::OnScroll

CSplitter W nd::DoScrollBy

virtual BOOL DoScrollBy( CView* pViewFrom , CSize sizeScroll,BOOL bDoScroll

= TRUE );

返回值

如果发生了同步滚动则返回非零值；否则返回 0 。

参数

pViewFrom

指向一个视的指针，滚动消息就是从这个视发出的。

sizeScroll

要水平和垂直滚动的像素数。

bDoScroll

确定是否可以发生指定的滚动动作。如果 bDoScroll 是 TRUE （就是说，

如果一个子窗口存在，并且此分隔窗口有一个滚动范围），则指定的滚动动作可以发生；如果 bDoScroll 是 FALSE （就是说，如果不存在一个子窗口，或此分隔视没有滚动范围），则滚动将不会发生。

说明

在响应一个滚动消息时，框架调用此成员函数来执行此分隔窗口的同步滚动，滚动由 sizeScroll 指定的像素数。正值表示向下和向右滚动，负值表示向上和向左滚动。

重载这个函数，在滚动允许之前请求一个由用户指定的动作。

请参阅 CSplitterWnd::DoScroll, CView::OnScroll

CSplitter W nd::GetActivePane

virtual CWnd* GetActivePane(int* pRow = NULL, int* pCol = NULL);

返回值

返回指向活动窗格的指针。如果不存在活动窗格则返回 NULL 。

参数

pRow

指向一个用来接收此活动窗格的行号的 int 的指针。

pCol

指向一个用来接收此活动窗格的列号的 int 的指针。

说明

框架调用此成员函数来确定一个分隔器窗口中的活动窗格。

重载这个函数，在获得此活动窗格之前请求一个由用户指定的动作。

请参阅 CSplitterWnd::SetActivePane, CFrameWnd::GetActiveView,CWnd::GetParentFrame,

CWnd::GetFocus CSplitter W nd::GetColumnCount int GetColumnCount( );

返回值

返回此分隔器中的当前列数。对一个静态分隔器，这也是行数的最大值。

请参阅 CSplitterWnd::GetRowCount

CSplitter W nd::GetColumnInfo

void GetColumnInfo( int co l, int& cxCu r , int& cxMin );

参数

col

指定一列。

cxCur

个要用来设置列的当前宽度的 int 的引用。

cxMin

个要用来设置列的当前最小宽度的 int 的引用。

说明

此成员函数用来获取指定列的信息。

请参阅 CSplitterWnd::SetColumnInfo, CSplitterWnd::GetRowInfo

CSplitter W nd::GetPane

CWnd* GetPane( int row , int col );

返回值

返回位于指定行和列处的窗格。此返回窗格通常是一个 CView 派生类。

参数

row

指定一行。

col

指定一列。

请参阅 CSplitterWnd::GetActivePane, CSplitterWnd::IdFromRowCol, CSplitterWnd::IsChildPane

CSplitter W nd::GetRowCount

int GetRowCount( );

返回值

返回此分隔器窗口中的当前行数。对一个静态分隔器窗口，这也是最大行数。

请参阅 CSplitterWnd::GetColumnCount

CSplitter W nd::GetRowInfo

void GetRowInfo( int row , int& cyCu r , int& cyMin );

参数

row

指定一行。

cyCur

一个要用来设置行的当前高度的 int 的引用。

cyMin

一个要用来设置行的当前最小高度的 int 的引用。

说明

此成员函数用来获取指定行的信息。 cyCur 参数用指定行的当前高度来填充，

cyWin 用该行的最小高度来填充。

请参阅 CSplitterWnd::SetRowInfo, CSplitterWnd::GetColumnInfo

CSplitter W nd::GetScrollStyle

DWORD GetScrollStyle( ) const;

如果成功，则返回下列窗口风格标志的一个或多个：

WS_HSCROLL 如果分隔器当前管理共享的水平滚动条。
WS_VSCROLL 如果分隔器当前管理共享的垂直滚动条。如

果分隔器窗口当前不管理任何共享滚动条，则返回零。

说明

此成员函数返回此分隔器窗口的共享滚动条的风格。

请参阅 CSplitterWnd::SetScrollStyle

CSplitter W nd::IdFromRowCol

int IdFromRowCol( int row , int col );

返回此窗格的子窗口的 ID 。

参数

row

指定分隔器窗口的行。

col

指定分隔器窗口的列。

说明

此成员函数用来获取位于指定行和列处的窗格的子窗口 ID 。这个成员函数用于创建非视类的窗格，并且可以在该窗格存在之前被调用。

请参阅 CSplitterWnd::GetPane, CSplitterWnd::IsChildPane

CSplitter W nd::IsChild Pane

BOOL IsChildPane( CWnd* pWnd , int& row , int& col );

返回值

若返回值是非零值，则 pWnd 是此分隔器窗口的子窗格，并且该函数将此分隔器窗口的窗格的位置填写到 row 和 col 中。如果 pWnd 不是此分隔器窗口的子窗口，则返回 0 。

参数

pWnd

指向一个要被测试的 CWnd 对象的指针。

row

是对一个将要被设置为行号的 int 的引用。

col

是对一个将要被设置为列号的 int 的引用。

说明

此成员函数用来确定 pWnd 是否是此分隔器窗口的子窗口。

请参阅 CSplitterWnd::GetPane

CSplitter W nd::OnDrawSplitter

virtual void OnDrawSplitter( CDC* pD C , ESplitType nType , const CRect& rect );

参数

pDC

一个指向设备环境的指针，将要在这个设备上绘画。如果 pDC 是 NULL ，则框架调用 CWnd::RedrawWindow 并且没有分隔窗口被绘制。

nType

一个 enum ESplitType 值，可以是下列值之一：

splitBox 分隔器拖拉框。
splitBar 显示在两个分隔窗口之间的条。
splitIntersection 分隔窗口的交。当在 Windows95 下允许时

，不会调用这个元素。
splitBorder 分隔窗口边界。

rect

是对一个用来指定分隔窗口的大小和形状的 CRect 对象的引用。

说明

框架调用此成员函数来绘制并指定一个分隔器窗口的精确的特征。

要对一个分隔器窗口的各个图形部件的图像进行高级定制，可以重载

OnDrawSplitter 。缺省的图像与 Microsoft Works for Windows 或 Microsoft W indows 95 中的分隔器类似。在 M icrosoft W orks for Windows 或 Microsoft W indows 95 中分隔器条的交接处是混合在一起的。

有关静态分隔器窗口的更多信息，参见“ V isual C++ 程序员指南 ” 中的文章 “ 多文档类型，视和框架窗口 ”中的“ 分隔器窗口 ”；“ Visual C++ 文档 ”中的“ TN029 ：分隔器窗口 ” ；以及 CSplitterWnd 类概述。

请参阅 CSplitterWnd::OnInvertTracker

CSplitter W nd::OnInvertTracker

virtual void OnInvertTracker( const CRect& rect );

参数

rect

是对一个指定跟踪矩形的 CRect 对象的引用。

说明

在调整分隔器大小期间，框架调用此成员函数。

要对一个分隔器窗口的图像进行高级定制，可以重载 OnInvertTracker。缺省的图像与 Microsoft Works for Windows 或 Microsoft Windows 95 中的分隔器类似。在 M icrosoft W orks for Windows 或 Microsoft Windows 95 中分隔器条的交接处是混合在一起的。

请参阅 CSplitterWnd::OnDrawSplitter

CSplitter W nd::RecalcLayout

void RecalcLayout( );

说明

在你用 SetRowInfo 和 SetColumnInfo 成员函数调整了行和列的大小之后，调用此成员函数来正确地重新显示此分隔器窗口。如果你是在分隔器窗口可见之前改变行和列的大小作为创建过程的一部分，则不需要调用这个成员函数。

无论什么时候用户调整此分隔器窗口的大小或移动一个分隔条，框架都将调用这个成员函数。

请参阅 CSplitterWnd::SetRowInfo, CSplitterWnd::SetColumnInfo

CSplitter W nd::SetActivePane

virtual void SetActivePane( int row , int co l, CWnd* pWnd = NULL );

参数

row

如果 pWnd 是 NULL ，则此参数指定将要被激活的窗格中的行。

col

如果 pWnd 是 NULL ，则此参数指定将要被激活的窗格中的列。

pWnd

个指向 CWnd 对象的指针。如果是 NULL ，则由 row 和
col 指定的窗格被置为活动窗格。如果不是 NULL ，则它指定了要被激活的窗格。

说明

当用户将焦点改变到框架窗口中的某一个窗格时，框架调用此成员函数来设置一个活动窗格。你可以显式地调用 SetActivePane 来将焦点改变到指定的视。

可以通过提供行和列，或 pWnd 来指定窗格。

请参阅 CSplitterWnd::GetActivePane, CSplitterWnd::GetPane, CFrameWnd::SetActiveView

CSplitter W nd::SetColumnInfo

void SetColumnInfo( int co l, int cxIdeal , int cxMin );

参数

col

指定一个分隔器窗口列。

cxIdeal

指定分隔器窗口列的以像素表示的理想宽度。

cxMin

指定分隔器窗口列以像素表示的最小宽度。

说明

此成员函数用来设置一列的新的最小宽度和理想宽度。列的最小值确定了什么时候列将太小以至于不能被完全显示。

当框架显示分隔器窗口时，它从分隔器窗口的客户区的左上角至右下角，根据窗格的理想尺寸按行和列来排放各个窗格。

请参阅 CSplitterWnd::GetRowInfo, CSplitterWnd::RecalcLayout

CSplitter W nd::SetRowInfo

void SetRowInfo( int row, int cyIdeal , int cyMin );

参数

row

指定一个分隔器窗口行。

cyIdeal

指定分隔器窗口行的以像素表示的理想高度。

cyMin

指定分隔器窗口行以像素表示的最小高度。

说明

此成员函数用来设置一行的新的最小高度和理想高度。行的最小值确定了什么时候行将太小以至于不能被完全显示。

当框架显示分隔器窗口时，它从分隔器窗口的客户区的左上角至右下角，根据窗格的理想尺寸按行和列来排放各个窗格。

请参阅 CSplitterWnd::GetRowInfo, CSplitterWnd::SetColumnInfo, CSplitterWnd::RecalcLayout

CSplitter W nd::SetScrollStyle

void SetScrollStyle( DWORD dwStyle );

参数

dwStyle

此分隔器窗口的共享滚动条所指出的滚动条风格，可以是下列值之一：

WS_HSCROLL 创建 /显示水平共享滚动条。
WS_VSCROLL 创建 /显示垂直共享滚动条。

说明

此成员函数用来为分隔器窗口的共享滚动条指定新的滚动条风格。一旦创建了一个滚动条，即使调用了没有这个风格的 SetScrollStyle ，此滚动条也不会被销毁；而是隐藏这些滚动条。在调用 SetScrollStyle 之后，为了使所有的改变见效，

必须调用 RecalcLayout 。

请参阅 CSplitterWnd::GetScrollStyle

CSplitter W nd::SplitColumn

virtual BOOL SplitColumn( int cxBefore );

返回值

如果成功则返回非零值；否则返回 0 。

参数

cxBefore

在分隔出现点前面的以像素表示的位置。

当创建了一个垂直的分隔器窗口时调用此成员函数。 SplitColumn 指明分隔要出现的缺省位置。

框架调用 SplitColumn 来实现动态分隔器窗口（即，分隔器窗口具有SPLS_DYNAMIC_ SPLIT 风格）的逻辑。可以用 CreateView 函数来定制它，以实现更为高级的动态分隔器。

请参阅 CSplitterWnd::CreateView, CSplitterWnd::SplitRow, CSplitterWnd::RecalcLayout

CSplitter W nd::SplitRow

virtual BOOL SplitRow( int cyBefore );

如果成功则返回非零值；否则返回 0 。

参数

cyBefore

在分隔出现点前面的以像素表示的位置。

说明

当创建了一个水平的分隔器窗口时调用此成员函数。 SplitRow 指明分隔要出现的缺省位置。

框架调用 SplitRow 来实现动态分隔器窗口（即，分隔器窗口具有

SPLS_DYNAMIC_SPLIT 风格）的逻辑。可以用 CreateView 函数来定制它，以

实现更为高级的动态分隔器。

请参阅 CSplitterWnd::SplitColumn, CSplitterWnd::CreateView, CSplitterWnd::RecalcLayout

CSplitter W nd

CSplitter W nd

CSplitterWnd 类 成 员

成 员 函 数

CSplitterWnd 类成员

成员函数