CToolBar::Create

Artikel
06/10/2015

Diese Memberfunktion stellt eine Windows-Symbolleiste (ein untergeordnetes Fenster) und ordnet ihn mit dem CToolBar-Objekt.

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

Parameter

pParentWnd
Zeiger auf das Fenster, das das übergeordnete Element der Symbolleiste befindet.
dwStyle
Das Symbolleistenformat. Die zusätzlichen unterstützten Symbolleistenformate sind:
- CBRS_TOP Steuerleiste wird am oberen Rand des Rahmenfensters.
- CBRS_BOTTOM Steuerleiste ist unten vom Rahmenfenster.
- CBRS_NOALIGN Steuerleiste wird nicht neu angeordnet, wenn das übergeordnete Element angepasst wird.
- CBRS_TOOLTIPS Steuerleiste wird QuickInfo an.
- CBRS_SIZE_DYNAMIC Steuerleiste ist dynamisch.
- CBRS_SIZE_FIXED Steuerleiste behoben ist.
- CBRS_FLOATING Steuerleiste unverankert ist.
- CBRS_FLYBY Statusleiste zeigt Informationen über die Schaltfläche an.
- CBRS_HIDE_INPLACE Steuerleiste wird dem Benutzer nicht angezeigt.
nID
ID des untergeordneten Fensters der Symbolleiste

Rückgabewert

Ungleich 0 (null), wenn erfolgreich; 0 andernfalls.

Hinweise

Sie wird auch die Symbolleistenhöhe auf einen Standardwert fest.

Beispiel

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