Partager via


CToolBarCtrl::Create

Crée un contrôle de barre d'outils et l'attache à un objet d' CToolBarCtrl .

virtual BOOL Create( 
   DWORD dwStyle, 
   const RECT& rect, 
   CWnd* pParentWnd, 
   UINT nID  
);

Paramètres

  • dwStyle
    Spécifie le style du contrôle de barre d'outils. Les barres d'outils doivent toujours avoir le style de WS_CHILD . En outre, vous pouvez spécifier n'importe quelle combinaison des styles et des styles de fenêtre de barre d'outils comme décrit dans Notes.

  • rect
    Spécifie éventuellement la taille et la position du contrôle de barre d'outils. Ce peut être un objet de CRect ou une structure de RECT .

  • pParentWnd
    Spécifie la fenêtre parente du contrôle de barre d'outils. Il ne doit pas être NULL.

  • nID
    Spécifie l'ID du contrôle de barre d'outils

Valeur de retour

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

Notes

Vous construisez CToolBarCtrl en deux étapes. D'abord, appelez le constructeur, puis appelez Créer, qui crée le contrôle de barre d'outils et l'attache à l'objet d' CToolBarCtrl . Appliquez des styles de fenêtre suivants à un contrôle de barre d'outils.

  • WS_CHILD toujours

  • WS_VISIBLE habituellement

  • WS_DISABLED rarement

Consultez CreateWindow dans Kit de développement logiciel Windows pour une description des styles de fenêtre.

Éventuellement, appliquez une combinaison de styles de contrôles communs, comme décrit dans Kit de développement logiciel Windows.

Appliquez une combinaison des styles de barre d'outils au contrôle ou aux boutons eux-mêmes. Les styles sont décrits dans la rubrique contrôle de barre d'outils et styles des boutons dans Kit de développement logiciel Windows.

Pour utiliser des styles étendus de barre d'outils, appelez SetExtendedStyle après avoir appelé Créer. Pour créer une barre d'outils avec des styles de fenêtre étendus, appelez CToolBarCtrl::CreateEx au lieu de Créer.

Le contrôle de barre d'outils définit automatiquement la taille et la position de la fenêtre de barre d'outils. La hauteur est basée sur la hauteur des boutons dans la barre d'outils. La largeur est identique à la largeur de la zone cliente de la fenêtre parente. Les styles d' CCS_TOP et d' CCS_BOTTOM déterminent si la barre d'outils est positionnée le long de le haut ou le bas de la zone cliente. Par défaut, une barre d'outils est le style d' CCS_TOP .

Configuration requise

Header: afxcmn.h

Voir aussi

Référence

CToolBarCtrl, classe

Graphique de la hiérarchie

CToolBarCtrl::CToolBarCtrl

CToolBarCtrl::SetButtonStructSize