CSplitterWnd::CreateStatic
To create a static splitter window, call the CreateStatic member function.
virtual BOOL CreateStatic(
CWnd* pParentWnd,
int nRows,
int nCols,
DWORD dwStyle = WS_CHILD | WS_VISIBLE,
UINT nID = AFX_IDW_PANE_FIRST
);
Parameters
pParentWnd
The parent frame window of the splitter window.nRows
The number of rows. This value must not exceed 16.nCols
The number of columns. This value must not exceed 16.dwStyle
Specifies the window style.nID
The child window ID of the window. The ID can be AFX_IDW_PANE_FIRST unless the splitter window is nested inside another splitter window.
Return Value
Nonzero if successful; otherwise 0.
Remarks
A CSplitterWnd is usually embedded in a parent CFrameWnd or CMDIChildWnd object by taking the following steps:
Embed a CSplitterWnd member variable in the parent frame.
Override the parent frame's OnCreateClient member function.
Call the CreateStatic member function from within the overridden CFrameWnd::OnCreateClient.
A static splitter window contains a fixed number of panes, often from different classes.
When you create a static splitter window, you must at the same time create all its panes. The CreateView member function is usually used for this purpose, but you can create other nonview classes as well.
The initial minimum row height and column width for a static splitter window is 0. These minimums, which determine when a pane is too small to be shown in its entirety, can be changed with the SetRowInfo and SetColumnInfo member functions.
To add scroll bars to a static splitter window, add the WS_HSCROLL and WS_VSCROLL styles to dwStyle.
See "Splitter Windows" in the article Multiple Document Types, Views, and Frame Windows, Technical Note 29, and the CSplitterWnd class overview for more on static splitter windows.
Requirements
Header: afxext.h