Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here.

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;
}

Community Additions

ADD
Show:
© 2015 Microsoft