Partager via


CToolBar::Create

Cette fonction membre crée une barre d'outils windows (une fenêtre enfant) et les associe à l'objet d' CToolBar .

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

Paramètres

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

  • dwStyle
    Le style de barre d'outils. Les styles supplémentaires de barre d'outils sont pris en charge :

    • La barre de contrôles d'CBRS_TOP est au sommet de la fenêtre frame.

    • La barre de contrôles d'CBRS_BOTTOM est en bas de la fenêtre frame.

    • La barre de contrôles d'CBRS_NOALIGN n'est pas repositionnée lorsque le parent est redimensionné.

    • La barre de contrôles d'CBRS_TOOLTIPS affiche des info-bulles.

    • La barre de contrôles deCBRS_SIZE_DYNAMIC est dynamique.

    • La barre de contrôles deCBRS_SIZE_FIXED est fixe.

    • La barre de contrôles deCBRS_FLOATING est flottante.

    • La barre d'état d'CBRS_FLYBY affiche des informations sur le bouton.

    • La barre de contrôles deCBRS_HIDE_INPLACE n'est pas affichée à l'utilisateur.

  • 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.

Exemple

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

Configuration requise

Header: afxext.h

Voir aussi

Référence

CToolBar, classe

Graphique de la hiérarchie

CToolBar::CToolBar

CToolBar::LoadBitmap

CToolBar::SetButtons

CToolBar::LoadToolBar

CControlBar::CalcDynamicLayout

CControlBar::CalcFixedLayout