CToolBar::Create

Article
03/04/2013

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