CToolBar::CreateEx

Artikel
02/26/2013

Rufen Sie diese Funktion auf, um eine Windows-Symbolleiste (ein untergeordnetes Fenster) erstellen und sie mit dem CToolBar-Objekt.

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

Parameter

pParentWnd
Zeiger auf das Fenster, das das übergeordnete Element der Symbolleiste befindet.
dwCtrlStyle
Zusätzliche Stile für die Erstellung eingebetteten CToolBarCtrl ein Objekt.Standardmäßig wird dieser Wert zu TBSTYLE_FLAT festgelegt.Eine vollständige Liste der Symbolleistenformaten, finden Sie unter dwStyle.
dwStyle
Das Symbolleistenformat.Siehe Symbolleisten-Steuerelement- und Schaltflächen-Formate in Windows SDK für eine Liste von entsprechenden Formaten.
rcBorders
Ein CRect-Objekt, das die Breite des Symbolleistenfensterrahmens definiert.Diese Rahmen werden standardmäßig auf 0,0,0,0, und mit dem Ergebnis eines Symbolleistenfensters ohne Kontext festgelegt.
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.

Verwenden Sie CreateEx, statt Erstellen Sie, wenn bestimmte Formatanforderung, während der Erstellung des eingebetteten Symbolleistensteuerelements vorhanden sein.Legen Sie beispielsweise dwCtrlStyle zu TBSTYLE_FLAT | TBSTYLE_TRANSPARENT fest, um eine Symbolleiste zu erstellen, die den Internet Explorer 4-Symbolleisten ähnelt.

Beispiel

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

Anforderungen

Header: afxext.h

Siehe auch

Referenz

CToolBar-Klasse

Hierarchien-Diagramm

Freigeben über