Partager via


CToolBar::CreateEx

Appelez cette fonction pour créer une barre d'outils windows (une fenêtre enfant) et l'associer à l'objet d' 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
);

Paramètres

  • pParentWnd
    Pointeur vers la fenêtre qui est le parent de la barre d'outils.

  • dwCtrlStyle
    Les styles supplémentaires pour la création de CToolBarCtrl incorporé objet.Par défaut, cette valeur est affectée à TBSTYLE_FLAT.Pour une liste complète des styles de barre d'outils, consultez l' dwStyle.

  • dwStyle
    Le style de barre d'outils.Consultez contrôle de barre d'outils et styles des boutons dans Kit de développement logiciel Windows pour obtenir une liste de styles appropriés.

  • rcBorders
    Un objet de CRect qui définit les largeurs des bordures de la fenêtre de barre d'outils.Ces zones sont la valeur 0,0,0,0 par défaut, de ce fait ce qui provoque une fenêtre de barre d'outils sans les zones.

  • nID
    ID de la fenêtre enfant de la barre d'outils

Valeur de retour

Une valeur différente de zéro si l'opération a réussi ; sinon 0.

Notes

Il définit également la hauteur de barre d'outils à une valeur par défaut.

Utilisez CreateEx, au lieu de Create, lorsque certains styles doivent être présents pendant la création du contrôle incorporé de barre d'outils.Par exemple, affectez dwCtrlStyle à TBSTYLE_FLAT | TBSTYLE_TRANSPARENT pour créer une barre d'outils semblable aux barres d'outils d'Internet Explorer 4.

Exemple

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

Configuration requise

Header: afxext.h

Voir aussi

Référence

Classe de CToolBar

Graphique de la hiérarchie