Classe de CToolBarCtrl

Article
03/04/2013

Fournit les fonctionnalités du contrôle commun de barre d'outils windows.

class CToolBarCtrl : public CWnd

Membres

Constructeurs publics

Nom	Description
CToolBarCtrl::CToolBarCtrl	Construit un objet CToolBarCtrl.

Méthodes publiques

Nom	Description
CToolBarCtrl::AddBitmap	Ajoute un ou plusieurs images de bouton bitmap à la liste d'images de bouton disponibles pour un contrôle de barre d'outils.
CToolBarCtrl::AddButtons	Ajoute un ou plusieurs boutons à un contrôle de barre d'outils.
CToolBarCtrl::AddString	Ajoute une nouvelle chaîne, passée comme un ID de ressource, à la liste interne de la barre d'outils de chaînes.
CToolBarCtrl::AddStrings	Ajoute une nouvelle chaîne ou chaînes, passées comme un pointeur vers une mémoire tampon des chaînes null séparées, à la liste interne de la barre d'outils de chaînes.
CToolBarCtrl::AutoSize	Redimensionne un contrôle de barre d'outils.
CToolBarCtrl::ChangeBitmap	Modifie la bitmap d'un bouton dans le contrôle de barre d'outils en cours.
CToolBarCtrl::CheckButton	Contrôles ou espaces libres un bouton donné dans un contrôle de barre d'outils.
CToolBarCtrl::CommandToIndex	Extrait l'index de base zéro pour le bouton associé à l'identificateur de commande spécifié.
CToolBarCtrl::Create	Crée un contrôle de barre d'outils et l'attache à un objet d' CToolBarCtrl .
CToolBarCtrl::CreateEx	Crée un contrôle de barre d'outils avec les styles étendus par windows spécifiées et l'attache à un objet d' CToolBarCtrl .
CToolBarCtrl::Customize	Affiche la boîte de dialogue de barre d'outils de personnaliser.
CToolBarCtrl::DeleteButton	Supprime un bouton du contrôle de barre d'outils.
CToolBarCtrl::EnableButton	Active ou désactive le bouton spécifié dans un contrôle de barre d'outils.
CToolBarCtrl::GetAnchorHighlight	Extrait la configuration de surbrillance d'ancrage d'une barre d'outils.
CToolBarCtrl::GetBitmap	Extrait l'index de la bitmap associée à un bouton dans une barre d'outils.
CToolBarCtrl::GetBitmapFlags	Obtient les balises associées à la bitmap de la barre d'outils.
CToolBarCtrl::GetButton	Récupère des informations sur le bouton spécifié dans un contrôle de barre d'outils.
CToolBarCtrl::GetButtonCount	Récupère un nombre des boutons actuel dans le contrôle de barre d'outils.
CToolBarCtrl::GetButtonInfo	Récupère les informations d'un bouton dans une barre d'outils.
CToolBarCtrl::GetButtonSize	Extrait la largeur et la hauteur actuelle des boutons de barre d'outils, en pixels.
CToolBarCtrl::GetColorScheme	Récupère le modèle de couleurs du contrôle de barre d'outils en cours.
CToolBarCtrl::GetDisabledImageList	Récupère la liste d'images qu'un contrôle de barre d'outils utilise pour afficher les boutons désactivés.
CToolBarCtrl::GetDropTarget	Récupère l'interface d' IDropTarget pour un contrôle de barre d'outils.
CToolBarCtrl::GetExtendedStyle	Récupère les styles étendus pour un contrôle de barre d'outils.
CToolBarCtrl::GetHotImageList	Récupère la liste d'images qu'un contrôle de barre d'outils utilise pour afficher les boutons « chauds ».Un bouton en cours apparaît en surbrillance lorsque le pointeur de la souris est au-dessus.
CToolBarCtrl::GetHotItem	Extrait l'index de l'élément réactif dans une barre d'outils.
CToolBarCtrl::GetImageList	Récupère la liste d'images qu'un contrôle de barre d'outils utilise pour afficher des boutons dans leur état par défaut.
CToolBarCtrl::GetInsertMark	Extrait la marque d'insertion actuel de la barre d'outils.
CToolBarCtrl::GetInsertMarkColor	Extrait la couleur utilisée pour dessiner la marque d'insertion de la barre d'outils.
CToolBarCtrl::GetItemRect	Récupère le rectangle englobant d'un bouton dans un contrôle de barre d'outils.
CToolBarCtrl::GetMaxSize	Extrait la taille totale de tous les boutons et séparateurs visibles dans la barre d'outils.
CToolBarCtrl::GetMaxTextRows	Récupère le nombre de lignes de texte affichent sur un bouton de barre d'outils.
CToolBarCtrl::GetMetrics	Extrait la métrique d'un contrôle de barre d'outils.
CToolBarCtrl::GetPadding	Extrait la marge intérieure horizontale et verticale du contrôle de barre d'outils en cours.
CToolBarCtrl::GetPressedImageList	Récupère la liste d'images que le contrôle de barre d'outils actuellement l'utilise pour représenter des boutons dans l'état enfoncé.
CToolBarCtrl::GetRect	Récupère le rectangle englobant d'un bouton de barre d'outils spécifié.
CToolBarCtrl::GetRows	Récupère le nombre de lignes de boutons actuellement affichés dans la barre d'outils.
CToolBarCtrl::GetState	Récupère des informations sur l'état du bouton spécifié dans un contrôle de barre d'outils, par exemple s'il est activé, enfoncé, ou contrôlé.
CToolBarCtrl::GetString	Extrait une chaîne de barre d'outils.
CToolBarCtrl::GetStyle	Récupère les styles en cours de utilisation pour un contrôle de barre d'outils.
CToolBarCtrl::GetToolTips	Récupère le handle du contrôle d'info-bulle, le cas échéant, associé au contrôle de barre d'outils.
CToolBarCtrl::HideButton	Masque ou affiche le bouton spécifié dans un contrôle de barre d'outils.
CToolBarCtrl::HitTest	Détermine si un point se situe dans un contrôle de barre d'outils.
CToolBarCtrl::Indeterminate	Définit ou espaces libres l'état (gris) indéterminé du bouton spécifié dans un contrôle de barre d'outils.
CToolBarCtrl::InsertButton	Insère un bouton dans un contrôle de barre d'outils.
CToolBarCtrl::InsertMarkHitTest	Extrait les informations de marque d'insertion pour un point dans une barre d'outils.
CToolBarCtrl::IsButtonChecked	Indique si le bouton spécifié dans un contrôle de barre d'outils est activée.
CToolBarCtrl::IsButtonEnabled	Indique si le bouton spécifié dans un contrôle de barre d'outils est activé.
CToolBarCtrl::IsButtonHidden	Indique si le bouton spécifié dans un contrôle de barre d'outils est masquée.
CToolBarCtrl::IsButtonHighlighted	Contrôle l'état de mise en surbrillance du bouton de barre d'outils.
CToolBarCtrl::IsButtonIndeterminate	Indique si l'état du bouton spécifié dans un contrôle de barre d'outils est indéterminé (gris).
CToolBarCtrl::IsButtonPressed	Indique si le bouton spécifié dans un contrôle de barre d'outils est enfoncé.
CToolBarCtrl::LoadImages	Bitmap de charge dans la liste d'images d'un contrôle de barre d'outils.
CToolBarCtrl::MapAccelerator	Mappe un caractère d'accélérateur à un bouton de barre d'outils.
CToolBarCtrl::MarkButton	Définit l'état de mise en surbrillance d'un bouton donné dans un contrôle de barre d'outils.
CToolBarCtrl::MoveButton	Déplace un bouton d'un index à un autre.
CToolBarCtrl::PressButton	Pressions ou release le bouton spécifié dans un contrôle de barre d'outils.
CToolBarCtrl::ReplaceBitmap	Remplace la bitmap existante dans le contrôle de barre d'outils en cours par une nouvelle bitmap.
CToolBarCtrl::RestoreState	Restaure l'état du contrôle de barre d'outils.
CToolBarCtrl::SaveState	Enregistre l'état du contrôle de barre d'outils.
CToolBarCtrl::SetAnchorHighlight	Définit la configuration de surbrillance d'ancrage d'une barre d'outils.
CToolBarCtrl::SetBitmapSize	Définit la taille des images générées une correspondance de bits à ajouter à un contrôle de barre d'outils.
CToolBarCtrl::SetButtonInfo	Définit les informations d'un bouton existant dans une barre d'outils.
CToolBarCtrl::SetButtonSize	Définit la taille des boutons à ajouter à un contrôle de barre d'outils.
CToolBarCtrl::SetButtonStructSize	Spécifie la taille de la structure d' TBBUTTON .
CToolBarCtrl::SetButtonWidth	Définit le minimum et la largeur maximale de bouton dans le contrôle de barre d'outils.
CToolBarCtrl::SetCmdID	Définit l'identificateur de commande à envoyer à la fenêtre propriétaire lorsque le bouton spécifié est enfoncé.
CToolBarCtrl::SetColorScheme	Définit le modèle de couleurs du contrôle de barre d'outils en cours.
CToolBarCtrl::SetDisabledImageList	Définit la liste d'images que le contrôle de barre d'outils utilisera pour afficher les boutons désactivés.
CToolBarCtrl::SetDrawTextFlags	Définit les balises dans la fonction DrawText, qui Win32 est utilisée pour dessiner le texte dans le rectangle spécifié, mis en forme en fonction de la façon dont les balises sont définies.
CToolBarCtrl::SetExtendedStyle	Définit les styles étendus pour un contrôle de barre d'outils.
CToolBarCtrl::SetHotImageList	Définit la liste d'images que le contrôle de barre d'outils utilisera pour afficher les boutons « chauds ».
CToolBarCtrl::SetHotItem	Définit l'élément réactif dans une barre d'outils.
CToolBarCtrl::SetImageList	Définit la liste d'images que la barre d'outils utilisera pour afficher des boutons qui sont dans leur état par défaut.
CToolBarCtrl::SetIndent	Définit la mise en retrait pour le premier bouton dans un contrôle de barre d'outils.
CToolBarCtrl::SetInsertMark	Définit la marque d'insertion actuel de la barre d'outils.
CToolBarCtrl::SetInsertMarkColor	Définit la couleur utilisée pour dessiner la marque d'insertion de la barre d'outils.
CToolBarCtrl::SetMaxTextRows	Définit le nombre de lignes de texte affichent sur un bouton de barre d'outils.
CToolBarCtrl::SetMetrics	Définit la métrique d'un contrôle de barre d'outils.
CToolBarCtrl::SetOwner	Définit la fenêtre pour recevoir des messages de notification du contrôle de barre d'outils.
CToolBarCtrl::SetPadding	Définit la marge intérieure horizontale et verticale du contrôle de barre d'outils en cours.
CToolBarCtrl::SetPressedImageList	Définit la liste d'images que le contrôle de barre d'outils actuellement l'utilise pour représenter des boutons dans l'état enfoncé.
CToolBarCtrl::SetRows	Définit le nombre de lignes de boutons affichent dans la barre d'outils.
CToolBarCtrl::SetState	Définit l'état du bouton spécifié dans un contrôle de barre d'outils.
CToolBarCtrl::SetStyle	Définit les styles pour un contrôle de barre d'outils.
CToolBarCtrl::SetToolTips	Associe un contrôle d'info-bulle avec le contrôle de barre d'outils.
CToolBarCtrl::SetWindowTheme	Définit le style visuel d'un contrôle de barre d'outils.

Notes

Ce contrôle (et par conséquent la classe d' CToolBarCtrl ) est disponible uniquement aux programmes s'exécutant sous la version 3,51 de Windows 95/98 et Windows NT et versions ultérieures.

Un contrôle commun de 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 dans la fenêtre propriétaire de la barre d'outils.En général, les boutons d'une barre d'outils correspondent aux éléments du menu de l'application ; ils offrent un moyen plus directe pour que l'utilisateur accède aux commandes d'une application.

Les objets d'CToolBarCtrl contiennent plusieurs structures de données internes importantes : une liste de bitmap d'images de bouton ou d'une liste d'images, une liste d'étiquettes de bouton chaînes, et une liste de structures d' TBBUTTON qui associent une image chaîne et/ou à la position, dénomment, l'état, et d'ID de commande du bouton.Chacun des éléments de ces structures de données est indiqué par un index de base zéro.Avant de pouvoir utiliser un objet d' CToolBarCtrl , vous devez installer ces structures de données.La liste de chaînes ne peut être utilisée pour les étiquettes de bouton ; vous ne pouvez pas extraire des chaînes de la barre d'outils.

Pour utiliser un objet d' CToolBarCtrl , vous exécuterez généralement ces étapes :

Construisez l'objet d' CToolBarCtrl .
Appelez Create pour créer le contrôle commun de barre d'outils windows et le lier à l'objet d' CToolBarCtrl .Pointez sur le style de la barre d'outils à l'aide de les 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 déroulants de style.
Identifiez la façon dont vous souhaitez les boutons de la barre d'outils affiche :
- Pour utiliser des images bitmap pour les boutons, ajoutez des images de bouton à la barre d'outils en appelant AddBitmap.
- Pour utiliser des images restituées d'une liste d'images pour les boutons, spécifiez la liste d'images en appelant SetImageList, SetHotImageList, ou SetDisabledImageList.
- Pour utiliser des étiquettes de chaîne pour des boutons, ajoutez les chaînes à la barre d'outils en appelant AddString et/ou AddStrings.
Ajoutez les squelettes de bouton à la barre d'outils en appelant AddButtons.
Si vous souhaitez que les info-bulles pour un bouton de barre d'outils dans une fenêtre propriétaire qui n'est pas CFrameWnd, vous devez gérer les messages de TTN_NEEDTEXT dans la fenêtre propriétaire de la barre d'outils comme décrit dans notifications d'Info-bulle de gestion.Si la fenêtre parente de la barre d'outils est dérivée d' CFrameWnd, les info-bulles sont affichées sans effort supplémentaire de vous car CFrameWnd fournit un gestionnaire par défaut.
Si vous souhaitez que votre utilisateur pour pouvoir personnaliser la barre d'outils, gérer les messages de notification de personnalisation dans la fenêtre propriétaire comme décrit dans notifications de personnalisation de gestion.

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 selon les informations précédemment stockées dans le Registre.En plus de l'enregistrement de l'état de la barre d'outils entre les utilisations de l'application, mémoire des applications en général l'état avant que l'utilisateur commence personnalisation de la barre d'outils au cas où l'utilisateur souhaiterait ultérieurement restaurer la barre d'outils à son état d'origine.

Prise en charge la version 4,0 de microsoft Internet Explorer et versions ultérieures

Pour prendre en charge la fonctionnalité introduite dans Internet Explorer, la version 4,0 et ultérieure, MFC fournit la prise en charge de liste d'images et les styles transparents et en deux dimensions des contrôles de barre d'outils.

Une barre d'outils transparente permet au client situé sous la barre d'outils à afficher.Pour créer une barre d'outils transparente, utilisez les styles de TBSTYLE_FLAT et de TBSTYLE_TRANSPARENT .Les barres d'outils transparentes impliquent la sélection réactive ; autrement dit, lorsque le pointeur de la souris passe sur un bouton actif dans la barre d'outils, l'apparence du bouton change.Les barres d'outils créées avec uniquement le style de TBSTYLE_FLAT contiendront des boutons qui ne sont pas transparents.

La prise en charge de la liste d'images fournit une plus grande souplesse de contrôle du comportement par défaut, les images chaudes, et les images désactivées.Utilisez GetImageList, GetHotImageList, et GetDisabledImageList avec la barre d'outils transparente pour manipuler l'image en fonction de son état :

Pour plus d'informations sur l'utilisation CToolBarCtrl, consultez contrôles et l' Utilisation CToolBarCtrl.