Share via

CDockablePane::Create

  • Article

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

virtual BOOL Create(
    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
);
virtual BOOL Create(
    LPCTSTR lpszWindowName,
    CWnd* pParentWnd,
    CSize sizeDefault,
    BOOL bHasGripper,
    UINT nID,
    DWORD dwStyle = WS_CHILD|WS_VISIBLE|CBRS_TOP|CBRS_HIDE_INPLACE,
    DWORD dwTabbedStyle = AFX_CBRS_REGULAR_TABS,
    DWORD dwControlBarStyle = AFX_DEFAULT_DOCKING_PANE_STYLE
);

Parameters

  • [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 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 additional style attributes.

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

  • [in] lpszWindowName
    Specifies the window name.

  • [in] sizeDefault
    Specifies the size 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

Reference

CDockablePane Class

Hierarchy Chart