CToolBar::Create

Статья
10/16/2008

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

Параметры

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 code fragment is taken from CMainFrame::OnCreate
// CMainFrame is derived from CMDIFrameWnd.

//This example creates a dockable toolbar.
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);