CToolBarCtrl

La classe CToolBarCtrl fournit les fonctionnalités du contrôle commun barre d'outils Windows. Ce contrôle (et donc la classe CToolBarCtrl ) sont disponible seulement pour les programmes qui s'exécutent sous Windows 95 et Windows NT version 3.51 ou ultérieure.

Un contrôle commun de la barre d'outils Windows est une fenêtre enfant rectangulaire qui contient un ou plusieurs boutons. Ces boutons peuvent afficher une image bitmap, une chaîne ou les deux. Lorsque l'utilisateur choisit un bouton, il envoie un message de commande de la fenêtre propriétaire de la barre d'outils. Généralement, les boutons d'une barre d'outils correspondent aux éléments de menu de l'application ; ils fournissent un moyen plus direct pour l'utilisateur d'accéder aux commandes d'une application.

Objets CToolBarCtrl contiennent plusieurs structures de données internes importantes : une liste de bouton image bitmaps ou une liste d'images, une liste des piqûres d'étiquette de bouton et une liste de structures TBBUTTON qui, associé à une image ou chaîne à la position, de style, d'État et ID du bouton de commande. Chacun des éléments de ces structures de données est appelé par un index de base zéro. Avant que vous pouvez utiliser un objet CToolBarCtrl , vous devez configurer ces structures de données. La liste des chaînes ne peut être utilisée pour les étiquettes des boutons ; vous ne peut pas récupérer les chaînes de la barre d'outils.

Pour utiliser un objet CToolBarCtrl , vous suivra généralement ces étapes:

  1. Construire l'objet CToolBarCtrl.

  2. Appelez Create pour créer le contrôle commun de la barre d'outils Windows et le joindre à l'objet CToolBarCtrl . Indiquer le style de la barre d'outils en utilisant des styles, tels que TBSTYLE_TRANSPARENT pour une barre d'outils transparente ou TBSTYLE_DROPDOWN pour une barre d'outils qui prend en charge les boutons de menu déroulant style.

  3. Identifier comment vous voulez que les boutons de la barre d'outils affichée:
    • Pour utiliser des images bitmap pour les boutons, ajoutez les bitmaps bouton à la barre d'outils en appelant AddBitmap.

    • Pour utiliser les images affichées dans une liste d'images pour les boutons, spécifiez la liste d'images en appelant SetImageList, SetHotImageListou SetDisabledImageList.

    • Pour utiliser des étiquettes de chaîne pour les boutons, ajoutez les chaînes à la barre d'outils en appelant AddString ou AddStrings.
  4. Ajouter des structures de bouton à la barre d'outils en appelant AddButtons.

  5. Si vous voulez des infobulles pour un bouton de barre d'outils dans une fenêtre propriétaire qui n'est pas une classe CFrameWnd, vous avez besoin gérer les messages TTN_NEEDTEXT dans la fenêtre propriétaire de la barre d'outils, comme décrit dans CToolBarCtrl : manipulation Tool Tip Notifications. Si la fenêtre parent de la barre d'outils est dérivée de CFrameWnd, infobulles sont affichés sans effort supplémentaire de votre part parce que la classe CFrameWnd fournit un gestionnaire par défaut.

  6. Si vous voulez votre utilisateur pour être en mesure de personnaliser la barre d'outils, gérer les messages de notification de personnalisation dans la fenêtre propriétaire comme décrit dans CToolBarCtrl : traitement des Notifications de personnalisation.

Vous pouvez utiliser SaveState pour enregistrer l'état actuel d'un contrôle de barre d'outils dans le registre et RestoreState pour restaurer l'état basé sur les informations déjà stockées dans le registre. En plus de l'enregistrement de l'état de la barre d'outils entre les utilisations de l'application, les applications stockent généralement l'état avant que l'utilisateur commence à personnaliser la barre d'outils dans le cas où l'utilisateur veut restaurer la barre d'outils dans son état original plus tard.

Support pour Internet Explorer Version 4.0 et ultérieures

À l'appui de la fonctionnalité introduite dans Internet Explorer, version 4.0 et ultérieure, MFC fournit un appui de liste d'image et transparents et plats styles pour les contrôles de barre d'outils.

Une barre d'outils transparente permet au client sous la barre d'outils montrer à travers. Pour créer une barre d'outils transparente, utilisez des styles de rencontrer et de TBSTYLE_TRANSPARENT . Barres d'outils transparentes en vedette chaud suivi ; C'est lorsque le pointeur de la souris se déplace au-dessus d'un bouton chaude sur la barre d'outils, apparition du bouton change. Créé avec juste le style de rencontrer de barres d'outils contient des boutons qui ne sont pas transparentes.

Support liste d'image permet une plus grande souplesse de contrôle pour le comportement par défaut, les images chaudes et images handicapés. Utiliser GetImageList, GetHotImageListet GetDisabledImageList avec la barre d'outils transparente pour manipuler l'image selon son état:

Pour plus d'informations sur l'utilisation de CToolBarCtrl, voir Sujets contrôle et à l'aide de CToolBarCtrl dans le Guide du programmeur Visual C++.

# include lt;afxcmn.h>

Membres de la classe |  ; Classe de base | Graphique de la hiérarchie

Échantillons denbsp ; MFC exemple CMNCTRL1 | MFC exemple MFCIE

Voir aussi  ;CToolBar

Index