CDockablePane::CreateEx

Creates the Windows control and attaches it to the CDockablePane object.

virtual BOOL CreateEx(
    DWORD dwStyleEx,
    LPCTSTR lpszCaption,
    CWnd* pParentWnd,
    const RECT& rect,
    BOOL bHasGripper,
    UINT nID,
    DWORD dwStyle,
    DWORD dwTabbedStyle = AFX_CBRS_REGULAR_TABS,
    DWORD dwControlBarStyle = AFX_DEFAULT_DOCKING_PANE_STYLE,
    CCreateContext* pContext = NULL
);

Parameters

  • [in] dwStyleEx
    Specifies the extended style attributes for the new window.

  • [in] lpszCaption
    Specifies the window name.

  • [in] [out] pParentWnd
    Specifies the parent window.

  • [in] rect
    Specifies the size and position of the window, in client coordinates of pParentWnd.

  • [in] bHasGripper
    TRUE to create the pane with a caption; otherwise, FALSE.

  • [in] nID
    Specifies the ID of the child window. This value must be unique if you want to save the docking state for this docking pane.

  • [in] dwStyle
    Specifies the window style attributes.

  • [in] dwTabbedStyle
    Specifies the tabbed style of a tabbed window that is created when the user drags a pane on the caption of this pane.

  • [in] dwControlBarStyle
    Specifies the additional style attributes.

  • [in] [out] pContext
    Specifies the create context of the window.

Return Value

TRUE if the dockable pane is successfully created; otherwise, FALSE.

Remarks

Creates a Windows pane and attaches it to the CDockablePane object.

If the dwStyle window style has the CBRS_FLOAT_MULTI flag, the miniframe window can float with other panes in the miniframe window. By default, docking panes can only float individually.

If the dwTabbedStyle parameter has the AFX_CBRS_OUTLOOK_TABS flag specified, the pane creates Outlook-style tabbed panes when another pane is attached to this pane using the CDockablePane::AttachToTabWnd method. By default, dockable panes create regular tabbed panes of type CTabbedPane.

Requirements

Header: afxDockablePane.h

See Also

Concepts

MFC Hierarchy Chart

Reference

CDockablePane Class