CToolBar::Create

Статья
02/20/2013

Эта функция-член создает панель инструментов Windows (дочернее окно) и связать его с объектом CToolBar.

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

Параметры

pParentWnd
Указатель на окно, родительский элемент панели инструментов.
dwStyle
Стиль панели инструментов.Дополнительные поддерживаемые стили панели инструментов:
- Панель элементов управления CBRS_TOP вверху фреймового окна.
- Панель элементов управления CBRS_BOTTOM в базовом классе фреймового окна.
- Панель элементов управления CBRS_NOALIGN не перемещена, если родительский размер.
- Панель элементов управления CBRS_TOOLTIPS отображает всплывающие подсказки.
- Панель элементов управления CBRS_SIZE_DYNAMIC динамическая.
- Панель элементов управления CBRS_SIZE_FIXED исправить.
- Панель элементов управления располагается CBRS_FLOATING.
- Строка состояния CBRS_FLYBY отображает сведения о кнопке.
- Панель элементов управления CBRS_HIDE_INPLACE не отображается для пользователя.
nID
Идентификатор дочернего окна панели инструментов

Возвращаемое значение

Ненулевой, если успешно; в противном случае – значение 0.

Заметки

Он также задает высоту панели инструментов по умолчанию.

Пример

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