Création d'un objet CToolBarCtrl
Les objets CToolBarCtrl contiennent plusieurs structures de données internes ( une liste de bitmaps d’image de bouton, une liste de chaînes d’étiquettes de bouton et une liste de TBBUTTON structures) qui associent une image et/ou une chaîne à la position, au style, à l’état et à l’ID de commande du bouton. Chacun des éléments de ces structures de données est référencé par un index de base zéro. Avant de pouvoir utiliser un CToolBarCtrl objet, vous devez configurer ces structures de données. Pour obtenir la liste des structures de données, consultez Contrôles de barre d’outils dans le Kit de développement logiciel (SDK) Windows. La liste des chaînes ne peut être utilisée que pour les étiquettes de bouton ; vous ne pouvez pas récupérer de chaînes à partir de la barre d’outils.
Pour utiliser un CToolBarCtrl objet, vous devez généralement suivre les étapes suivantes :
Pour utiliser un objet CToolBarCtrl
Construisez l’objet CToolBarCtrl .
Appelez Create pour créer le contrôle commun de la barre d’outils Windows et l’attacher à l’objet
CToolBarCtrl. Si vous souhaitez des images bitmap pour les boutons, ajoutez les bitmaps de bouton à la barre d’outils en appelant AddBitmap. Si vous souhaitez des étiquettes de chaîne pour les boutons, ajoutez les chaînes à la barre d’outils en appelant AddString et/ou AddStrings. Après avoir appeléAddStringet/ouAddStrings, vous devez appeler AutoSize pour obtenir la chaîne ou les chaînes à afficher.Ajoutez des structures de bouton à la barre d’outils en appelant AddButtons.
Si vous souhaitez obtenir des conseils sur les outils, gérez TTN_NEEDTEXT messages dans la fenêtre propriétaire de la barre d’outils, comme décrit dans Gestion des notifications d’info-bulles.
Si vous souhaitez que votre utilisateur puisse personnaliser la barre d’outils, gérez les messages de notification de personnalisation dans la fenêtre propriétaire, comme décrit dans Gestion des notifications de personnalisation.