CFrameWnd::Create

Syntax

BOOL Create( const char FAR* lpClassName, const char FAR* lpWindowName, DWORD dwStyle = WS_OVERLAPPEDWINDOW, const RECT& rect = rectDefault, const CWnd* pParentWnd = NULL, const char FAR* lpMenuName = NULL );

Parameters

lpClassName

Points to a null-terminated character string that names the Windows class (a WNDCLASS struct). The class name can be any name registered with the afxRegisterWndClass function or any of the predefined control-class names. If NULL, uses the predefined default CFrameWnd attributes.

lpWindowName

Points to a null-terminated character string that represents the window name. Used as text for the title bar.

dwStyle

Specifies the window style attributes. See the CreateEx member function in the CWnd class for a full list of window styles.

rect

Specifies the size and position of the window. The rectDefault value allows Windows to specify the size and position of the new CFrameWnd object.

pParentWnd

Specifies the parent window of this frame window. This parameter should be NULL for top-level frame windows.

lpMenuName

Identifies the name of the menu resource to be used with the window. Use MAKEINTRESOURCE if the menu has an integer ID instead of a string. This parameter can be NULL.

Remarks

Construct a CFrameWnd object in two steps. First invoke the constructor, which constructs the CFrameWnd object, then call Create, which creates the Windows frame window and attaches it to the CFrameWnd object. Create initializes the window's class name and window name and registers default values for its style, parent, and associated menu.

Return Value

TRUE if initialization is successful; otherwise FALSE.

See Also

CFrameWnd::CFrameWnd, CFrameWnd::~CFrameWnd, CWnd::CreateEx