This documentation is archived and is not being maintained.

CToolBar::Create 

This member function creates a Windows toolbar (a child window) and associates it with the CToolBar object.


virtual BOOL Create(
   CWnd* pParentWnd,
   DWORD dwStyle = WS_CHILD |  WS_VISIBLE | CBRS_TOP,
   UINT nID = AFX_IDW_TOOLBAR 
);

Parameters

pParentWnd

Pointer to the window that is the toolbar's parent.

dwStyle

The toolbar style. Additional toolbar styles supported are:

  • CBRS_TOP   Control bar is at top of the frame window.

  • CBRS_BOTTOM   Control bar is at bottom of the frame window.

  • CBRS_NOALIGN   Control bar is not repositioned when the parent is resized.

  • CBRS_TOOLTIPS   Control bar displays tool tips.

  • CBRS_SIZE_DYNAMIC   Control bar is dynamic.

  • CBRS_SIZE_FIXED   Control bar is fixed.

  • CBRS_FLOATING   Control bar is floating.

  • CBRS_FLYBY   Status bar displays information about the button.

  • CBRS_HIDE_INPLACE   Control bar is not displayed to the user.

nID

The toolbar's child-window ID.

Nonzero if successful; otherwise 0.

It also sets the toolbar height to a default value.

//This example creates a dockable toolbar.
int CMainFrame::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
   if (CFrameWnd::OnCreate(lpCreateStruct) == -1)
      return -1;
   
   if (!m_wndToolBar.Create(this) ||
      !m_wndToolBar.LoadToolBar(IDR_MAINFRAME))
   {
      TRACE0("Failed to create toolbar\n");
      return -1;      // fail to create
   }
   
   //Make the toolbar dockable
   m_wndToolBar.EnableDocking(CBRS_ALIGN_ANY);
   EnableDocking(CBRS_ALIGN_ANY);
   DockControlBar(&m_wndToolBar);
   
   return 0;
}
Show: