通过

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
    工具栏的子窗口ID.

返回值

非零，如果成功;否则为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选件类

层次结构图