CToolBar::Create

發行項
02/28/2013

此成員函式建立視窗工具列 (子視窗) 並將其與 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
工具列的子視窗 ID.

傳回值

如果不是零，則成功，則為 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);