CSplitterWnd::Create

發行項
02/28/2013

若要建立動態分隔視窗，請建立呼叫成員函式。

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 成員函式。
呼叫建立成員函式從覆寫的 OnCreateClient的內部。

當您建立分隔視窗自父框架的內部時，可透過父框架的 pContext 參數加入分隔視窗。否則，這個參數可以是 NULL。

動態分隔視窗的初始的最小資料行高度和寬度是由 sizeMin 參數設定為。這些最小值，判斷窗格是否太小而無法顯示所有檔案，可以變更與 SetRowInfo 和 SetColumnInfo 成員函式。

如需詳細在動態分隔視窗，請參閱<分隔視窗」本文許多資料型別、檢視和框架視窗、 Technical Note 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);
}