Condividi tramite


CToolBar::CreateEx

Chiamare la funzione per creare una barra degli strumenti di Windows (una finestra figlio) e associarlo all'oggetto 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 
);

Parametri

  • pParentWnd
    Puntatore alla finestra che è il padre della barra degli strumenti.

  • dwCtrlStyle
    Gli stili aggiuntivi per la creazione CToolBarCtrl incorporato oggetto. Per impostazione predefinita, questo valore è impostato su TBSTYLE_FLAT. Per un elenco completo degli stili della barra degli strumenti, vedere dwStyle.

  • dwStyle
    Lo stile della barra degli strumenti. Vedere Controllo della barra degli strumenti e stili del pulsante in Windows SDK per un elenco di stili appropriati.

  • rcBorders
    Un oggetto CRect che definisce le larghezze i bordi della finestra della barra degli strumenti. Tali margini sono impostati su 0,0,0,0 per impostazione predefinita, pertanto con conseguente finestra della barra degli strumenti senza i bordi.

  • nID
    Identificazione della finestra figlio della barra degli strumenti

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Note

Consente anche di impostare l'altezza della barra degli strumenti a un valore predefinito.

Utilizzare CreateEx, anziché Crea, quando determinati stili devono essere presenti durante la creazione del controllo barra degli strumenti incorporata. Ad esempio, impostare dwCtrlStyle a TBSTYLE_FLAT | TBSTYLE_TRANSPARENT per creare una barra degli strumenti simile a quella delle barre degli strumenti di Internet Explorer 4.

Esempio

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

Requisiti

Header: afxext.h

Vedere anche

Riferimenti

Classe CToolBar

Grafico delle gerarchie