Поделиться через


CToolBar::CreateEx

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

virtual BOOL CreateEx( 
   CWnd* pParentWnd, 
   DWORD dwCtrlStyle = TBSTYLE_FLAT, 
   DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_ALIGN_TOP, 
   CRect rcBorders = CRect( 
   0, 
   0, 
   0, 
   0 
), 
   UINT nID = AFX_IDW_TOOLBAR 
);

Параметры

  • pParentWnd
    Указатель на окно, родительский элемент панели инструментов.

  • dwCtrlStyle
    Дополнительные стили для создания внедренного CToolBarCtrl объект. По умолчанию это значение устанавливается в TBSTYLE_FLAT. Полный список стилей панели инструментов см. в разделе dwStyle.

  • dwStyle
    Стиль панели инструментов. См. раздел Стили элемента управления " Панель инструментов и кнопки в Windows SDK список соответствующих стилей.

  • rcBorders
    Объект CRect, указывающий ширину границ окна панели инструментов. Эти границы установлены в каталог по умолчанию 0,0,0,0, таким образом, полученный в окне панели инструментов без границ.

  • nID
    Идентификатор дочернего окна панели инструментов

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

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

Заметки

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

Используйте CreateEx вместо Создание, когда некоторые стили должен присутствовать во время создания внедренного элемента управления панели инструментов. Например, можно задать dwCtrlStyle к TBSTYLE_FLAT | TBSTYLE_TRANSPARENT чтобы создать панель инструментов, похожий на панели инструментов Internet Explorer 4.

Пример

// This example demonstrates CToolBar::CreateEx by creating a  
// toolbar as part of a child frame window. It also calls the  
// LoadToolbar and EnableDocking functions 
int CChildFrame::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
   if (CMDIChildWnd::OnCreate(lpCreateStruct) == -1)
      return -1;

   if (!m_wndMyToolBar.CreateEx(this, TBSTYLE_FLAT, WS_CHILD | WS_VISIBLE | CBRS_TOP
      | CBRS_GRIPPER | CBRS_TOOLTIPS | CBRS_FLYBY | CBRS_SIZE_DYNAMIC) ||
      !m_wndMyToolBar.LoadToolBar(IDR_MYTOOLBAR))
   {
      TRACE0("Failed to create toolbar\n");
      return -1;      // fail to create
   }

   m_wndMyToolBar.EnableDocking(CBRS_ALIGN_ANY);
   EnableDocking(CBRS_ALIGN_ANY);
   DockControlBar(&m_wndMyToolBar);

   return 0;
}

Требования

Header: afxext.h

См. также

Ссылки

Класс CToolBar

Диаграмма иерархии