CSplitterWnd::Create

项目
06/09/2015

若要创建动态拆分窗口，请调用 Create 成员函数。

virtual BOOL Create( 
   CWnd* pParentWnd, 
   int nMaxRows, 
   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  
);

参数

pParentWnd
拆分窗口的父框架窗口。
nMaxRows
最大行数在拆分窗口的。此值不能超过2。
nMaxCols
最大列数在拆分窗口的。此值不能超过2。
sizeMin
指定窗格可能会显示的最小尺寸。
pContext
为 CCreateContext 结构的指针。在大多数情况下，这可能是 pContext 传递到父框架窗口。
dwStyle
指定窗口样式。
nID
窗口的子窗口ID。除非拆分窗口嵌套在另一个拆分窗口中，ID可以是 AFX_IDW_PANE_FIRST。

返回值

非零，如果成功;否则为0。

备注

在父 CFrameWnd 或 CMDIChildWnd 对象中嵌入 CSplitterWnd 通过执行以下步骤:

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

当您创建一个拆分窗口和父级框架的内部时，传递父级框架的 pContext 参数到拆分窗口。否则，此参数可以是 NULL。

动态拆分窗口的初始最小行高度和列宽。sizeMin 参数设置为。这些最小值，确定窗格是否太小而无法显示全文，可以更改与 SetRowInfo 和 SetColumnInfo 成员函数。

有关更多在动态拆分窗口，请参见“拆分” Windows该文章多个文件类型、视图和框架Windows、技术说明29和 CSplitterWnd 选件类概述中。

示例

// the following function is created by the MFC Application Wizard  
// when you select Split window from the User Interface Features tab: 
BOOL CMyChildFrame::OnCreateClient(LPCREATESTRUCT /*lpcs*/, CCreateContext* pContext)
{
    return m_wndSplitter.Create(this,
        2, 2,       // TODO: adjust the number of rows, columns
        CSize(10, 10),  // TODO: adjust the minimum pane size
        pContext);
}