共用方式為

CToolBar::CreateEx

  • 發行項

呼叫這個函式會建立視窗工具列 (子視窗) 並且使其與 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，而不是 建立。例如，將設定為 dwCtrlStyleTBSTYLE_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 類別

階層架構圖