SECLayoutDockFactory::CreateDockableNodeWnd

Create a dockable HWND based layout node

Defined in: DockFactory.cpp

Syntax

CreateDockableNodeWnd(UINT nIDAttachWnd,CWnd* pParentWnd,LPCTSTR lpszTitle=NULL,BOOL bAutoScale=FALSE,SECLayoutNode** ppNodeWnd=NULL,DWORD dwGripperStyle=0)

CreateDockableNodeWnd(UINT nIDAttachWnd,CWnd* pParentWnd,const SECLayoutNodeWndClassFactory& classNodeWnd,LPCTSTR lpszTitle=NULL,BOOL bAutoScale=FALSE,SECLayoutNode** ppNodeWnd=NULL,DWORD dwGripperStyle=0)

CreateDockableNodeWnd(CWnd* pAttachWnd,CWnd* pParentWnd,LPCTSTR lpszTitle=NULL,BOOL bAutoScale=FALSE,SECLayoutNode** ppNodeWnd=NULL,DWORD dwGripperStyle=0)

CreateDockableNodeWnd(CWnd* pAttachWnd,CWnd* pParentWnd,const SECLayoutNodeWndClassFactory& classNodeWnd,LPCTSTR lpszTitle=NULL,BOOL bAutoScale=FALSE,SECLayoutNode** ppNodeWnd=NULL,DWORD dwGripperStyle=0);

Return Value

Pointer to the docking wrapper of the newly created HWND node. Memory management is automatic, caller should *not* deallocate.

Parameters

nIDAttachWnd

Child window id for SECLayoutNodeWnd attachment

pParentWnd

Parent window of the new dockable node

lpszTitle

Title for this docking wrapper. The title will be displayed when floating.

bAutoScale

If TRUE, all children of node will automatically be scaled on resize.

ppNodeWnd

Back pointer to the nested newly created HWND node in case furher initialization is needed.

dwGripperStyle

This flag is currently unused and reserved for future growth.

classNode

Runtime class name for dockable HWND node instantiation. Caller can utilize the NODEWND_CLASS(ClassName) macro for parameter passing.

Comments

This function will create a new layout HWND node and wrap it in a dockable gripper wrapper. The dockable gripper wrapper is returned and should be utilized in any docking operation. The ppNodeWnd back pointer is provided if further customization of the newly created node is required.

See Also

CreateDockableNode

SECFrameDockingFeatureBase::DockNode

SECLayoutFactory::CreateNodeWnd