La classe `CMFCToolBar`

Article
07/05/2024

La CMFCToolBar classe ressemble à CToolBar Class, mais fournit une prise en charge supplémentaire des fonctionnalités d’interface utilisateur. Celles-ci incluent les barres d'outils à deux dimensions, les barres d'outils avec images interactives, les grandes icônes, les boutons pager, les barres d'outils verrouillées, les contrôles rebar, le texte sous les images, les images d'arrière-plan et les barres d'outils avec onglets. La classe CMFCToolBar contient également une prise en charge intégrée de la personnalisation des barres d'outils et des menus par l'utilisateur, du glisser-déplacer entre les barres d'outils et les menus, des boutons de zone de liste modifiable, des boutons de zone d'édition, des sélecteurs de couleurs et des boutons de regroupement.

Pour plus d’informations, consultez le code source situé dans votre installation de Visual Studio, par exemple %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Syntaxe

class CMFCToolBar : public CMFCBaseToolBar

Membres

Constructeurs publics

Nom	Description
`CMFCToolBar::CMFCToolBar`	Constructeur par défaut.
`CMFCToolBar::~CMFCToolBar`	Destructeur.

Méthodes publiques

Nom	Description
`CMFCToolBar::AddBasicCommand`	Ajoute une commande de menu à la liste des commandes qui sont toujours affichées lorsqu’un utilisateur ouvre un menu.
`CMFCToolBar::AddCommandUsage`	Incrémente par un compteur associé à la commande donnée.
`CMFCToolBar::AddToolBarForImageCollection`	Ajoute des images des ressources de l’interface utilisateur à la collection d’images dans l’application.
`CMFCToolBar::AdjustLayout`	Recalcule la taille et la position d’une barre d’outils. (remplace `CBasePane::AdjustLayout`).
`CMFCToolBar::AdjustSize`	Recalcule la taille de la barre d’outils.
`CMFCToolBar::AllowChangeTextLabels`	Spécifie si les étiquettes de texte peuvent être affichées sous des images sur les boutons de barre d’outils.
`CMFCToolBar::AreTextLabels`	Spécifie si les étiquettes de texte sous les images sont actuellement affichées sur les boutons de barre d’outils.
`CMFCToolBar::AutoGrayInactiveImages`	Active ou désactive la génération automatique d’images de bouton inactives.
`CMFCToolBar::ButtonToIndex`	Retourne l’index d’un objet Class spécifié `CMFCToolBarButton` dans cette barre d’outils.
`CMFCToolBar::CalcFixedLayout`	Calcule la taille horizontale de la barre d’outils. (Substitue `CBasePane::CalcFixedLayout`.)
`CMFCToolBar::CalcSize`	Appelé par l’infrastructure dans le cadre du processus de calcul de disposition. (Substitue `CPane::CalcSize`.)
`CMFCToolBar::CanHandleSiblings`	Détermine si la barre d'outils et son frère sont placés sur le même volet.
`CMFCToolBar::CleanUpImages`	Libère les ressources système allouées pour les images de barre d’outils.
`CMFCToolBar::CleanUpLockedImages`	Libère les ressources système allouées pour les images de barre d’outils verrouillées.
`CMFCToolBar::CanBeClosed`	Spécifie si un utilisateur peut fermer la barre d’outils. (Substitue `CBasePane::CanBeClosed`.)
`CMFCToolBar::CanBeRestored`	Détermine si le système peut restaurer une barre d’outils à son état d’origine après la personnalisation.
`CMFCToolBar::CanFocus`	Spécifie si le volet peut recevoir le focus. (Substitue `CBasePane::CanFocus`.)
`CMFCToolBar::CanHandleSiblings`	Détermine si la barre d'outils et son frère sont placés sur le même volet.
`CMFCToolBar::CommandToIndex`	Retourne l’index du bouton dans la barre d’outils avec un ID de commande spécifié.
`CMFCToolBar::Create`	Crée un objet `CMFCToolBar`.
`CMFCToolBar::CreateEx`	Crée un objet qui utilise des `CMFCToolBar` options de style supplémentaires, telles que des icônes volumineuses.
`CMFCToolBar::Deactivate`	Désactive la barre d’outils.
`CMFCToolBar::EnableCustomizeButton`	Active ou désactive le bouton Ajouter ou supprimer des boutons qui s’affichent à la fin de la barre d’outils.
`CMFCToolBar::EnableDocking`	Active l’ancrage du volet sur le cadre principal. (Substitue `CBasePane::EnableDocking`.)
`CMFCToolBar::EnableLargeIcons`	Active ou désactive les grandes icônes sur les boutons de barre d’outils.
`CMFCToolBar::EnableQuickCustomization`	Active ou désactive la personnalisation rapide des barres d’outils afin que l’utilisateur puisse appuyer sur la touche Alt et faire glisser un bouton vers un nouvel emplacement.
`CMFCToolBar::EnableReflections`	Active ou désactive la réflexion des commandes.
`CMFCToolBar::EnableTextLabels`	Active ou désactive les étiquettes de texte sous les images de bouton de barre d’outils.
`CMFCToolBar::FromHandlePermanent`	Récupère un pointeur vers l’objet `CMFCToolBar` qui contient le handle de fenêtre donné.
`CMFCToolBar::GetAllButtons`	Renvoie une liste de boutons en lecture seule dans une barre d’outils.
`CMFCToolBar::GetAllToolbars`	Renvoie une liste en lecture seule de toutes les barres d’outils de l’application.
`CMFCToolBar::GetBasicCommands`	Renvoie une liste en lecture seule des commandes de base définies dans l’application.
`CMFCToolBar::GetButton`	Retourne un pointeur vers l’objet `CMFCToolBarButton` qui a un index de bouton de barre d’outils spécifié.
`CMFCToolBar::GetButtonInfo`	Retourne l’ID de commande, le style et l’index d’image du bouton à un index spécifié.
`CMFCToolBar::GetButtonSize`	Retourne les dimensions de chaque bouton de la barre d’outils.
`CMFCToolBar::GetButtonStyle`	Retourne le style actuel du bouton de barre d’outils situé à l’index spécifié.
`CMFCToolBar::GetButtonText`	Retourne l’étiquette de texte d’un bouton qui a un index spécifié.
`CMFCToolBar::GetColdImages`	Retourne un pointeur vers la collection d’images de bouton de barre d’outils à froid dans l’application.
`CMFCToolBar::GetColumnWidth`	Retourne la largeur des boutons de barre d’outils.
`CMFCToolBar::GetCommandButtons`	Retourne une liste de boutons qui ont un ID de commande spécifié à partir de toutes les barres d’outils de l’application.
`CMFCToolBar::GetCount`	Retourne le nombre de boutons et de séparateurs dans la barre d’outils.
`CMFCToolBar::GetCustomizeButton`	Récupère un pointeur vers l’objet `CMFCCustomizeButton` associé à la barre d’outils.
`CMFCToolBar::GetDefaultImage`	Retourne l’index de l’image par défaut d’un bouton de barre d’outils avec un ID de commande spécifié.
`CMFCToolBar::GetDisabledImages`	Retourne un pointeur vers la collection d’images utilisées pour les boutons de barre d’outils désactivés dans l’application.
`CMFCToolBar::GetDisabledMenuImages`	Retourne un pointeur vers la collection d’images utilisées pour les boutons de menu désactivés dans l’application.
`CMFCToolBar::GetDroppedDownMenu`	Récupère un pointeur vers l’objet bouton de menu qui affiche actuellement son sous-menu.
`CMFCToolBar::GetGrayDisabledButtons`	Spécifie si les images des boutons désactivés sont des versions grisées des images de bouton standard ou extraites de la collection d’images de bouton désactivées.
`CMFCToolBar::GetHighlightedButton`	Retourne un pointeur vers le bouton de barre d’outils actuellement mis en surbrillance.
`CMFCToolBar::GetHotBorder`	Détermine si les boutons de barre d’outils sont suivis à chaud.
`CMFCToolBar::GetHotTextColor`	Retourne la couleur de texte des boutons de barre d’outils mis en surbrillance.
`CMFCToolBar::GetHwndLastFocus`	Retourne un handle dans la fenêtre qui avait le focus d’entrée juste avant la barre d’outils.
`CMFCToolBar::GetIgnoreSetText`	Spécifie si les appels à définir des étiquettes de bouton sont ignorés.
`CMFCToolBar::GetImageSize`	Retourne la taille actuelle des images de bouton de barre d’outils.
`CMFCToolBar::GetImages`	Retourne un pointeur vers la collection d’images de bouton par défaut dans l’application.
`CMFCToolBar::GetImagesOffset`	Retourne le décalage d’index utilisé pour rechercher les images de bouton de barre d’outils pour cette barre d’outils dans la liste globale des images de bouton de barre d’outils.
`CMFCToolBar::GetInvalidateItemRect`	Récupère la région de la zone cliente qui doit être redessinée pour le bouton à l’index donné.
`CMFCToolBar::GetItemID`	Retourne l’ID de commande du bouton de barre d’outils à un index spécifié.
`CMFCToolBar::GetItemRect`	Retourne le rectangle englobant du bouton à un index spécifié.
`CMFCToolBar::GetLargeColdImages`	Retourne un pointeur vers la collection d’images de bouton de barre d’outils à froid volumineuses dans l’application.
`CMFCToolBar::GetLargeDisabledImages`	Retourne un pointeur vers la collection d’images de bouton de barre d’outils désactivées volumineuses dans l’application.
`CMFCToolBar::GetLargeImages`	Retourne un pointeur vers la collection d’images de bouton de barre d’outils volumineuses dans l’application.
`CMFCToolBar::GetLockedColdImages`	Retourne un pointeur vers la collection d’images froides verrouillées dans la barre d’outils.
`CMFCToolBar::GetLockedDisabledImages`	Retourne un pointeur vers la collection d’images désactivées verrouillées dans la barre d’outils.
`CMFCToolBar::GetLockedImages`	Retourne un pointeur vers la collection d’images de bouton verrouillées dans la barre d’outils.
`CMFCToolBar::GetLockedImageSize`	Retourne la taille par défaut des images de barre d’outils verrouillées.
`CMFCToolBar::GetLockedMenuImages`	Retourne un pointeur vers la collection d’images de menu de barre d’outils verrouillées dans la barre d’outils.
`CMFCToolBar::GetMenuButtonSize`	Retourne la taille des boutons de menu dans l’application.
`CMFCToolBar::GetMenuImageSize`	Retourne la taille des images de bouton de menu dans l’application.
`CMFCToolBar::GetMenuImages`	Retourne un pointeur vers la collection d’images de bouton de menu dans l’application.
`CMFCToolBar::GetOrigButtons`	Récupère la collection de boutons non personnalisés de la barre d’outils.
`CMFCToolBar::GetOrigResetButtons`	Récupère la collection de boutons de réinitialisation non personnalisés de la barre d’outils.
`CMFCToolBar::GetResourceID`	Récupère l’ID de ressource de la barre d’outils.
`CMFCToolBar::GetRouteCommandsViaFrame`	Détermine l’objet, le cadre parent ou le propriétaire, envoie des commandes à la barre d’outils.
`CMFCToolBar::GetRowHeight`	Retourne la hauteur des boutons de barre d’outils.
`CMFCToolBar::GetShowTooltips`	Spécifie si les info-bulles sont affichées pour les boutons de barre d’outils.
`CMFCToolBar::GetSiblingToolBar`	Récupère le frère de la barre d’outils.
`CMFCToolBar::GetUserImages`	Retourne un pointeur vers la collection d’images de bouton de barre d’outils définies par l’utilisateur dans l’application.
`CMFCToolBar::HitTest`	Retourne l’index du bouton de barre d’outils situé à la position spécifiée.
`CMFCToolBar::InsertButton`	Insère un bouton dans la barre d’outils.
`CMFCToolBar::InsertSeparator`	Insère un séparateur dans la barre d’outils.
`CMFCToolBar::InvalidateButton`	Invalide la zone cliente du bouton de barre d’outils qui existe à l’index fourni.
`CMFCToolBar::IsAddRemoveQuickCustomize`	Détermine si un utilisateur peut ajouter ou supprimer des boutons de barre d’outils à l’aide de l’option Personnaliser le menu.
`CMFCToolBar::IsAltCustomizeMode`	Spécifie si la personnalisation rapide est utilisée pour faire glisser un bouton.
`CMFCToolBar::IsAutoGrayInactiveImages`	Spécifie si la génération automatique d’images de bouton inactives (non mises en surbrillance) est activée.
`CMFCToolBar::IsBasicCommand`	Détermine si une commande figure dans la liste des commandes de base.
`CMFCToolBar::IsButtonExtraSizeAvailable`	Détermine si la barre d’outils peut afficher des boutons qui ont des bordures étendues.
`CMFCToolBar::IsButtonHighlighted`	Détermine si un bouton de la barre d’outils est mis en surbrillance.
`CMFCToolBar::IsCommandPermitted`	Détermine si une commande est autorisée.
`CMFCToolBar::IsCommandRarelyUsed`	Détermine si une commande est rarement utilisée (voir `CMFCToolBar::SetCommandUsageOptions`).
`CMFCToolBar::IsCustomizeMode`	Spécifie si l’infrastructure de barre d’outils est en mode de personnalisation.
`CMFCToolBar::IsDragButton`	Détermine si un bouton de barre d’outils est déplacé.
`CMFCToolBar::IsExistCustomizeButton`	Détermine si la barre d’outils contient le bouton Personnaliser .
`CMFCToolBar::IsFloating`	Détermine si la barre d’outils est flottante.
`CMFCToolBar::IsLargeIcons`	Spécifie si les barres d’outils de l’application affichent actuellement de grandes icônes.
`CMFCToolBar::IsLastCommandFromButton`	Détermine si la commande la plus récente exécutée a été envoyée à partir du bouton de barre d’outils spécifié.
`CMFCToolBar::IsLocked`	Détermine si la barre d’outils est verrouillée.
`CMFCToolBar::IsOneRowWithSibling`	Détermine si la barre d’outils et sa barre d’outils frère sont positionnées sur la même ligne.
`CMFCToolBar::IsUserDefined`	Spécifie si la barre d’outils est définie par l’utilisateur.
`CMFCToolBar::LoadBitmap`	Charge les images de barre d’outils à partir des ressources de l’application.
`CMFCToolBar::LoadBitmapEx`	Charge les images de barre d’outils à partir des ressources de l’application. Inclut des images volumineuses.
`CMFCToolBar::LoadParameters`	Charge les options de barre d’outils globales à partir du Registre Windows.
`CMFCToolBar::LoadState`	Charge les informations d’état de la barre d’outils à partir du Registre Windows. (Substitue `CPane::LoadState`.)
`CMFCToolBar::LoadToolBar`	Charge la barre d’outils à partir des ressources d’application.
`CMFCToolBar::LoadToolBarEx`	Charge la barre d’outils à partir des ressources d’application à l’aide de la `CMFCToolBarInfo` classe d’assistance pour permettre à l’application d’utiliser des images volumineuses.
`CMFCToolBar::OnChangeHot`	Appelé par l’infrastructure lorsqu’un utilisateur sélectionne un bouton dans la barre d’outils.
`CMFCToolBar::OnFillBackground`	Appelé par l’infrastructure pour remplir l’arrière-plan de `CBasePane::DoPaint` la barre d’outils.
`CMFCToolBar::OnReset`	Restaure la barre d’outils à son état d’origine.
`CMFCToolBar::OnSetAccData`	(Substitue `CBasePane::OnSetAccData`.)
`CMFCToolBar::OnSetDefaultButtonText`	Restaure le texte d’un bouton de barre d’outils à son état par défaut.
`CMFCToolBar::OnUpdateCmdUI`	Utilisé en interne.
`CMFCToolBar::RemoveAllButtons`	Supprime tous les boutons de la barre d’outils.
`CMFCToolBar::RemoveButton`	Supprime le bouton avec l’index spécifié de la barre d’outils.
`CMFCToolBar::RemoveStateFromRegistry`	Supprime les informations d’état de la barre d’outils du Registre Windows.
`CMFCToolBar::ReplaceButton`	Remplace un bouton de barre d’outils par un autre bouton de barre d’outils.
`CMFCToolBar::ResetAll`	Restaure toutes les barres d’outils à leurs états d’origine.
`CMFCToolBar::ResetAllImages`	Efface toutes les collections d’images de barre d’outils dans l’application.
`CMFCToolBar::RestoreOriginalState`	Restaure l'état initial d'une barre d'outils.
`CMFCToolBar::SaveState`	Enregistre les informations d’état de la barre d’outils dans le Registre Windows. (Substitue `CPane::SaveState`.)
`CMFCToolBar::Serialize`	(Substitue `CBasePane::Serialize`.)
`CMFCToolBar::SetBasicCommands`	Définit la liste des commandes qui sont toujours affichées lorsqu’un utilisateur ouvre un menu.
`CMFCToolBar::SetButtonInfo`	Définit l’ID de commande, le style et l’ID d’image d’un bouton de barre d’outils.
`CMFCToolBar::SetButtonStyle`	Définit le style du bouton de barre d’outils à l’index donné.
`CMFCToolBar::SetButtonText`	Définit l’étiquette de texte d’un bouton de barre d’outils.
`CMFCToolBar::SetButtons`	Définit les boutons de la barre d’outils.
`CMFCToolBar::SetCommandUsageOptions`	Spécifie quand les commandes rarement utilisées n’apparaissent pas dans le menu de l’application.
`CMFCToolBar::SetCustomizeMode`	Active ou désactive le mode de personnalisation pour toutes les barres d’outils de l’application.
`CMFCToolBar::SetGrayDisabledButtons`	Spécifie si les boutons désactivés de la barre d’outils sont grisés ou si les images désactivées sont utilisées pour les boutons désactivés.
`CMFCToolBar::SetHeight`	Définit la hauteur de la barre d’outils.
`CMFCToolBar::SetHotBorder`	Spécifie si les boutons de barre d’outils sont suivis à chaud.
`CMFCToolBar::SetHotTextColor`	Définit la couleur du texte pour les boutons de barre d’outils chauds.
`CMFCToolBar::SetLargeIcons`	Spécifie si les boutons de barre d’outils affichent de grandes icônes.
`CMFCToolBar::SetLockedSizes`	Définit les tailles des boutons verrouillés et des images verrouillées dans la barre d’outils.
`CMFCToolBar::SetMenuSizes`	Définit la taille des boutons de menu de barre d’outils et leurs images.
`CMFCToolBar::SetNonPermittedCommands`	Définit la liste des commandes qui ne peuvent pas être exécutées par l’utilisateur.
`CMFCToolBar::SetOneRowWithSibling`	Positionne la barre d’outils et son frère sur la même ligne.
`CMFCToolBar::SetPermament`	Spécifie si un utilisateur peut fermer la barre d’outils.
`CMFCToolBar::SetRouteCommandsViaFrame`	Spécifie si le cadre parent ou le propriétaire envoie des commandes à la barre d’outils.
`CMFCToolBar::SetShowTooltips`	Spécifie si l’infrastructure affiche des info-bulles.
`CMFCToolBar::SetSiblingToolBar`	Spécifie le frère de la barre d’outils.
`CMFCToolBar::SetSizes`	Spécifie les tailles des boutons et des images sur toutes les barres d’outils.
`CMFCToolBar::SetToolBarBtnText`	Spécifie les propriétés d’un bouton dans la barre d’outils.
`CMFCToolBar::SetTwoRowsWithSibling`	Positionne la barre d’outils et son frère sur des lignes distinctes.
`CMFCToolBar::SetUserImages`	Définit la collection d’images définies par l’utilisateur dans l’application.
`CMFCToolBar::StretchPane`	Étire la barre d’outils verticalement ou horizontalement. (Substitue `CBasePane::StretchPane`.)
`CMFCToolBar::TranslateChar`	Exécute une commande de bouton si le code de touche spécifié correspond à un raccourci clavier valide.
`CMFCToolBar::UpdateButton`	Met à jour l’état du bouton spécifié.
`CMFCToolBar::WrapToolBar`	Repositionne les boutons de barre d’outils dans les dimensions données.

Méthodes protégées

Nom	Description
`CMFCToolBar::AllowShowOnList`	Détermine si la barre d’outils est affichée dans la liste dans le volet Barres d’outils de la boîte de dialogue Personnaliser .
`CMFCToolBar::CalcMaxButtonHeight`	Calcule la hauteur maximale d’un bouton dans la barre d’outils.
`CMFCToolBar::DoPaint`	Repaint une barre d’outils.
`CMFCToolBar::DrawButton`	Repaint un bouton de barre d’outils.
`CMFCToolBar::DrawSeparator`	Repaint un séparateur dans une barre d’outils.
`CMFCToolBar::OnUserToolTip`	Appelé par l’infrastructure lorsque l’info-bulle d’un bouton est sur le point d’être affichée.

Données membres

Nom	Description
`CMFCToolBar::m_bDontScaleImages`	Spécifie s’il faut mettre à l’échelle ou non des images de barre d’outils en mode ppp élevé.
`CMFCToolBar::m_dblLargeImageRatio`	Spécifie le rapport entre la dimension (hauteur ou largeur) des images volumineuses et la dimension des images régulières.

Notes

Pour incorporer un CMFCToolBar objet dans votre application, procédez comme suit :

Ajoutez un CMFCToolBar objet à la fenêtre de cadre principale.
Lorsque vous traitez le message WM_CREATE pour la fenêtre cadre principale, appelez ou CMFCToolBar::Create CMFCToolBar::CreateEx créez la barre d’outils et spécifiez son style.
Appel CBasePane::EnableDocking pour spécifier le style d’ancrage.

Pour insérer un bouton spécial, tel qu’une zone de liste déroulante ou une barre d’outils déroulante, réservez un bouton factice dans la ressource parente et remplacez le bouton factice lors de l’exécution à l’aide CMFCToolBar::ReplaceButtonde . Pour plus d’informations, consultez Procédure pas à pas : Mise en place de contrôles dans les barres d’outils.

CMFCToolBarest la classe de base pour la classe, la classe, la classe et CMFCDropDownToolBar la classe de bibliothèque MFCCMFCMenuBar.CMFCPopupMenuBar

Exemple

L’exemple suivant montre comment utiliser différentes méthodes de la classe CMFCToolBar . L’exemple montre comment définir le texte de l’étiquette de fenêtre de la barre d’outils, définir les bordures, définir le style du volet et activer le bouton Ajouter ou supprimer des boutons qui s’affiche à la fin de la barre d’outils. Cet extrait de code fait partie de l’exemple de démonstration IE.

CMFCToolBar m_wndToolBar;

m_wndToolBar.SetWindowText(_T("Standard"));
m_wndToolBar.SetBorders();

//------------------------------------
// Remove toolbar gripper and borders:
//------------------------------------
m_wndToolBar.SetPaneStyle(m_wndToolBar.GetPaneStyle() &
                          ~(CBRS_GRIPPER | CBRS_BORDER_TOP | CBRS_BORDER_BOTTOM | CBRS_BORDER_LEFT | CBRS_BORDER_RIGHT));

m_wndToolBar.EnableCustomizeButton(TRUE, ID_VIEW_CUSTOMIZE, _T("Customize..."));

Spécifications

En-tête : afxtoolbar.h

Hiérarchie d'héritage

CMFCToolBar

`CMFCToolBar::AddBasicCommand`

Ajoute une commande de menu à la liste des commandes qui sont toujours affichées lorsqu’un utilisateur ouvre un menu.

static void __stdcall AddBasicCommand(UINT uiCmd);

Paramètres

uiCmd
[in] Spécifie la commande à ajouter.

Notes

Une commande de base est toujours affichée lorsque le menu est ouvert. Cette méthode est significative lorsque l’utilisateur choisit d’afficher les commandes récemment utilisées.

Utilisez la CMFCToolBar::SetBasicCommands méthode pour définir la liste des commandes qui sont toujours affichées lorsqu’un utilisateur ouvre un menu. Utilisez la CMFCToolBar::GetBasicCommands méthode pour récupérer la liste des commandes de base utilisées par votre application.

`CMFCToolBar::AddCommandUsage`

Incrémente par un compteur associé à la commande donnée.

static void __stdcall AddCommandUsage(UINT uiCommand);

Paramètres

uiCommand
[in] Spécifie le compteur de commandes à incrémenter.

Notes

L’infrastructure appelle cette méthode lorsque l’utilisateur sélectionne un élément de menu.

L’infrastructure utilise des compteurs de commandes pour afficher les éléments de menu récemment utilisés.

Cette méthode incrémente le compteur de commandes à l’aide de la CMFCCmdUsageCount::AddCmd méthode.

`CMFCToolBar::AddToolBarForImageCollection`

Ajoute des images des ressources de l’interface utilisateur à la collection d’images dans l’application.

static BOOL __stdcall AddToolBarForImageCollection(
    UINT uiResID,
    UINT uiBmpResID=0,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0);

Paramètres

uiResID
[in] ID de ressource d’une barre d’outils avec des images à charger.

uiBmpResID
[in] ID de ressource d’une bitmap avec des images de barre d’outils.

uiColdResID
[in] ID de ressource d’une bitmap avec des images de barre d’outils « froides ».

uiMenuResID
[in] ID de ressource d’une bitmap avec des images de menu.

uiDisabledResID
[in] ID de ressource d’une bitmap avec des images de barre d’outils désactivées.

uiMenuDisabledResID
[in] ID de ressource d’une bitmap avec des images de menu désactivées.

Valeur de retour

TRUE si la méthode réussit ; FALSE si uiResID des ressources valides ou uiBmpResID ne spécifient pas de ressources valides ou si une autre erreur se produit.

Notes

Appelez cette méthode pour charger une bitmap avec des images de barre d’outils et l’ajouter à la collection d’images de barre d’outils. Cette méthode crée un objet de barre d’outils temporaire et appelle CMFCToolBar::LoadToolBar.

`CMFCToolBar::AdjustLayout`

Recalcule la taille et la position d’une barre d’outils.

virtual void AdjustLayout();

Notes

Appelez cette méthode lorsque la barre d’outils a été créée pour recalculer sa taille et sa position.

L’infrastructure appelle cette méthode chaque fois que la disposition de la barre d’outils doit être modifiée. Par exemple, la disposition doit changer lorsque l’utilisateur déplace une autre barre de contrôle, redimensionne une fenêtre d’application ou personnalise la barre d’outils.

Remplacez cette méthode pour fournir votre propre disposition dynamique dans les classes que vous dérivez de CMFCToolbar.

`CMFCToolBar::AdjustSize`

Recalcule la taille de la barre d’outils.

void AdjustSize();

Notes

Cette méthode garantit que la barre d’outils s’adapte aux limites du cadre parent. Cette méthode ne fait rien si la barre d’outils n’a pas de frame parent.

La CMFCToolBar::AdjustLayout méthode appelle cette méthode pour recalculer la taille si le parent de la barre d’outils n’est pas un CMFCReBar objet.

`CMFCToolBar::AllowChangeTextLabels`

Spécifie si les étiquettes de texte peuvent être affichées sous des images sur les boutons de barre d’outils.

virtual BOOL AllowChangeTextLabels() const;

Valeur de retour

TRUE s’il est autorisé à afficher des étiquettes de texte sous les images ; sinon FALSE.

Notes

Cette méthode est appelée par la boîte de dialogue de personnalisation pour déterminer s’il faut activer une case à cocher Afficher les étiquettes de texte dans la page Barres d’outils de la barre d’outils sélectionnée.

L'implémentation par défaut retourne la valeur TRUE.

Remplacez cette méthode dans un objet dérivé et CMFCToolBar retournez FALSE lorsque vous ne souhaitez pas que l’utilisateur décide si les étiquettes de texte sont affichées sur les boutons de barre d’outils sous les images.

`CMFCToolBar::AllowShowOnList`

Détermine si la barre d’outils est affichée dans la liste des barres d’outils dans le volet Barres d’outils de la boîte de dialogue Personnaliser .

virtual BOOL AllowShowOnList() const;

Valeur de retour

TRUE si l’objet de barre d’outils peut être affiché dans la zone de liste de la page de personnalisation de la barre d’outils ; sinon FALSE.

Notes

Cette méthode est appelée par l’infrastructure pour déterminer si la liste de la page de personnalisation de la barre d’outils doit inclure un objet particulier dérivé de CMFCToolBar.

L’implémentation par défaut retourne TRUEtoujours . Remplacez cette méthode lorsque vous ne souhaitez pas qu’une barre d’outils apparaisse dans la liste des barres d’outils dans la boîte de dialogue de personnalisation.

`CMFCToolBar::AreTextLabels`

Spécifie si les étiquettes de texte sous les images sont actuellement affichées sur les boutons de barre d’outils.

BOOL AreTextLabels() const;

Valeur de retour

TRUE si les boutons de la barre d’outils affichent des étiquettes de texte sous les images ; sinon FALSE.

Notes

Permet CMFCToolBar::EnableTextLabels de spécifier si le texte est affiché. La valeur par défaut est FALSE. Appelez CMFCToolBar::AllowChangeTextLabels pour spécifier si l’utilisateur peut modifier ce paramètre dans la boîte de dialogue de personnalisation.

`CMFCToolBar::AutoGrayInactiveImages`

Active ou désactive la génération automatique d’images de bouton inactives.

static void AutoGrayInactiveImages(
    BOOL bEnable=TRUE,
    int nGrayImagePercentage=0,
    BOOL bRedrawAllToolbars=TRUE);

Paramètres

bEnable
[in] Valeur booléenne qui spécifie s’il faut désactiver les images inactives. Si ce paramètre est TRUE, les images inactives sont grisées. Sinon, les images inactives ne sont pas grisées.

nGrayImagePercentage
[in] Spécifie le pourcentage de luminance pour les images inactives. Si bEnable c’est FALSEle cas, cette valeur est ignorée.

bRedrawAllToolbars
[in] Valeur booléenne qui spécifie s’il faut redessiner toutes les barres d’outils de l’application. Si ce paramètre est TRUE, cette méthode redessine toutes les barres d’outils.

Notes

Si bEnable c’est TRUEle cas, l’infrastructure utilise nGrayImagePercentage pour générer des images inactives à partir des images régulières. Sinon, vous devez fournir l’ensemble d’images inactives à l’aide de la CMFCToolBar::GetColdImages méthode. Par défaut, cette option est désactivée.

Pour plus d'informations sur le paramètre nGrayImagePercentage, consultez CMFCToolBarImages::GrayImages.

`CMFCToolBar::ButtonToIndex`

Retourne l’index d’un objet Class spécifié CMFCToolBarButton dans cette barre d’outils.

int ButtonToIndex(const CMFCToolBarButton* pButton) const;

Paramètres

pButton
[in] Pointeur vers l’objet bouton de barre d’outils.

Valeur de retour

Index de pButton la liste interne des boutons de barre d’outils ; ou -1 si le bouton spécifié ne figure pas dans cette barre d’outils.

`CMFCToolBar::CalcFixedLayout`

Calcule la taille horizontale de la barre d’outils.

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Paramètres

bStretch
[in] TRUE pour étendre la barre d’outils à la taille du cadre parent.

bHorz
[in] TRUE pour orienter la barre d’outils horizontalement ; FALSE pour orienter la barre d’outils verticalement.

Valeur de retour

Objet CSize qui spécifie la taille de la barre d’outils.

Notes

Cette méthode calcule la taille de la barre d’outils à l’aide de la CMFCToolBar::CalcLayout méthode. Il transmet l’indicateur LM_STRETCH pour le dwMode paramètre si bStretch c’est TRUEle cas . Il passe l’indicateur si bHorz c’est .LM_HORZ TRUE

Consultez l’exemple VisualStudioDemo pour obtenir un exemple qui utilise cette méthode.

`CMFCToolBar::CalcMaxButtonHeight`

Calcule la hauteur maximale des boutons dans la barre d’outils.

virtual int CalcMaxButtonHeight();

Valeur de retour

Hauteur maximale des boutons.

Notes

Cette méthode calcule la hauteur maximale entre tous les boutons de barre d’outils de la barre d’outils. La hauteur peut varier en fonction de facteurs tels que l’état actuel d’ancrage de la barre d’outils.

Remplacez cette méthode dans une classe dérivée de CMFCToolBar pour fournir votre propre calcul de hauteur.

`CMFCToolBar::CalcSize`

Appelé par l’infrastructure dans le cadre du processus de calcul de disposition.

virtual CSize CalcSize(BOOL bVertDock);

Paramètres

bVertDock
[in] TRUE pour spécifier que la barre d’outils est ancrée verticalement ; FALSE pour spécifier que la barre d’outils est ancrée horizontalement.

Valeur de retour

Objet CSize qui spécifie la taille globale des boutons de la barre d’outils.

Notes

Cette méthode considère les attributs qui affectent la taille de chaque bouton, comme la zone de l’étiquette de texte et la taille de bordure.

Si la barre d’outils ne contient aucun bouton, cette méthode retourne la taille réservée d’un bouton unique à l’aide de la CMFCToolBar::GetButtonSize méthode.

`CMFCToolBar::CanBeClosed`

Spécifie si un utilisateur peut fermer la barre d’outils.

virtual BOOL CanBeClosed() const;

Valeur de retour

TRUE si la barre d’outils peut être fermée par l’utilisateur ; sinon FALSE.

Notes

L’infrastructure appelle cette méthode pour déterminer si l’utilisateur peut fermer une barre d’outils. Si la méthode est retournée TRUE, l’infrastructure active la SC_CLOSE commande dans le menu système de la barre d’outils et l’utilisateur peut fermer la barre d’outils à l’aide d’une case à cocher dans la liste des barres d’outils de la boîte de dialogue de personnalisation.

L'implémentation par défaut retourne la valeur TRUE. Remplacez cette méthode dans une classe dérivée de pour rendre les objets de CMFCToolBar barre d’outils qui ne peuvent pas être fermés par l’utilisateur.

`CMFCToolBar::CanBeRestored`

Détermine si le système peut restaurer une barre d’outils à son état d’origine après la personnalisation.

virtual BOOL CanBeRestored() const;

Valeur de retour

TRUE si la barre d’outils peut être restaurée à partir des ressources de l’application ; sinon FALSE.

Notes

L’infrastructure appelle cette méthode pour déterminer si une barre d’outils peut être retournée à son état d’origine après la personnalisation. L’état d’origine est chargé à partir des ressources de l’application.

Si CanBeRestored elle est retournée TRUE, la page Barres d’outils de la boîte de dialogue de personnalisation active le bouton Réinitialiser pour la barre d’outils sélectionnée.

L’implémentation par défaut retourne TRUE si l’ID de ressource d’origine de la barre d’outils lorsqu’elle a été chargée est différente de zéro. En règle générale, seules les barres d’outils définies par l’utilisateur ne peuvent pas être restaurées.

Vous pouvez remplacer la CanBeRestored méthode pour personnaliser ce comportement dans les classes dérivées.

`CMFCToolBar::CanFocus`

Spécifie si le volet peut recevoir le focus.

virtual BOOL CanFocus() const;

Valeur de retour

Cette méthode retourne FALSE.

Notes

Cette méthode remplace l’implémentation de classe de base, CBasePane::CanFocuscar les objets de barre d’outils ne peuvent pas recevoir le focus.

`CMFCToolBar::CanHandleSiblings`

Détermine si la barre d'outils et son frère sont placés sur le même volet.

BOOL CanHandleSiblings();

Valeur de retour

TRUE si la barre d’outils a un frère et que la barre d’outils et son frère sont positionnés sur le même volet ; sinon FALSE.

Notes

La méthode interne CMFCCustomizeButton::CreatePopupMenu appelle cette méthode pour déterminer comment afficher le menu contextuel Personnaliser . Si cette méthode est retournée TRUE, l’infrastructure affiche les boutons Afficher sur une ligne ou afficher les boutons sur deux lignes.

En règle générale, vous n'avez pas à utiliser cette méthode. Pour activer le bouton Personnaliser qui apparaît dans la barre d’outils, appelez la CMFCToolBar::EnableCustomizeButton méthode. Pour activer les boutons Afficher sur une seule ligne ou afficher les boutons sur deux boutons Lignes , appelez CMFCToolBar::SetSiblingToolBar.

`CMFCToolBar::CleanUpImages`

Libère les ressources système allouées pour les images de barre d’outils.

static void CMFCToolBar::CleanUpImages();

Notes

L’infrastructure appelle cette méthode lorsqu’une application s’arrête.

`CMFCToolBar::CleanUpLockedImages`

Libère les ressources système allouées pour les images de barre d’outils verrouillées.

void CleanUpLockedImages();

Notes

Appelez cette méthode lorsque le style visuel de votre application change. Consultez l’exemple VisualStudioDemo pour obtenir un exemple qui utilise cette méthode.

`CMFCToolBar::CommandToIndex`

Retourne l’index du bouton dans la barre d’outils avec un ID de commande spécifié.

int CommandToIndex(
    UINT nIDFind,
    int iIndexFirst=0) const;

Paramètres

nIDFind
[in] Spécifie l’ID de commande.

iIndexFirst
[in] Spécifie l’index initial à partir duquel commencer.

Valeur de retour

Index de base zéro du bouton de la barre d’outils si la méthode a réussi ; -1 s’il n’existe aucun bouton avec l’ID spécifié.

Notes

Un CMFCToolBar objet conserve une liste interne des boutons de la barre d’outils. Appelez cette fonction pour récupérer l’index d’un bouton dans la liste en fonction de l’ID de commande du bouton.

Si iIndex elle est supérieure à 0, cette méthode ignore tout bouton de la barre d’outils dont l’index est inférieur iIndexà .

`CMFCToolBar::Create`

Crée un objet CMFCToolBar.

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    UINT nID=AFX_IDW_TOOLBAR);

Paramètres

pParentWnd
[in] Pointeur vers la fenêtre parente de la barre d’outils.

dwStyle
[in] Style de barre d’outils. Consultez Le contrôle de barre d’outils et les styles de bouton dans le Kit de développement logiciel (SDK) Windows pour obtenir la liste des styles.

nID
[in] ID de la fenêtre enfant de la barre d’outils.

Valeur de retour

TRUE si cette méthode réussit ; sinon FALSE.

Notes

Cette méthode crée une barre de contrôle et l’attache à la barre d’outils. Il crée la barre de contrôle avec le style TBSTYLE_FLAT. Appelez CMFCToolBar::CreateEx si vous souhaitez un autre style de barre de contrôle.

`CMFCToolBar::CreateEx`

Crée un objet qui utilise des CMFCToolBar options de style supplémentaires, telles que des icônes volumineuses.

virtual BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle=TBSTYLE_FLAT,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    CRect rcBorders=CRect(1,
    1,
    1,
    1),
    UINT nID=AFX_IDW_TOOLBAR);

Paramètres

pParentWnd
[in] Pointeur vers la fenêtre parente de la barre d’outils.

dwCtrlStyle
[in] Styles supplémentaires pour la création de l’objet de barre de contrôle incorporée.

dwStyle
[in] Style de barre d’outils. Consultez Le contrôle de barre d’outils et les styles de bouton pour obtenir la liste des styles appropriés.

rcBorders
[in] Objet CRect qui spécifie les largeurs des bordures de la fenêtre de barre d’outils.

nID
[in] ID de la fenêtre enfant de la barre d’outils.

Valeur de retour

Différent de zéro si cette méthode réussit ; sinon 0.

Notes

Cette méthode crée une barre de contrôle et l’attache à la barre d’outils.

Appelez cette méthode plutôt CMFCToolBar::Create que lorsque vous souhaitez fournir des styles spécifiques. Par exemple, définissez cette option dwCtrlStyle pour TBSTYLE_FLAT | TBSTYLE_TRANSPARENT créer une barre d’outils qui ressemble aux barres d’outils utilisées par Internet Explorer 4.

Exemple

L’exemple suivant montre comment utiliser la CreateEx méthode de la CMFCToolBar classe. Cet extrait de code fait partie de l’exemple de démonstration IE.

CMFCToolBar m_wndToolBar;

// The this pointer points to CMainFrame class which extends the CFrameWnd class.
if (!m_wndToolBar.CreateEx(this, TBSTYLE_TRANSPARENT) ||
    !m_wndToolBar.LoadToolBar(IDR_MAINFRAME, uiToolbarColdID, uiMenuID,
                              FALSE /* Not locked */, 0, 0, uiToolbarHotID))
{
   TRACE0("Failed to create toolbar\n");
   return -1; // fail to create
}

`CMFCToolBar::Deactivate`

Désactive la barre d’outils.

virtual void Deactivate();

Notes

Cette méthode désactive la barre d’outils en supprimant le focus du bouton de barre d’outils mis en surbrillance. L’infrastructure appelle cette méthode lorsque la barre d’outils perd le focus ou est détruite.

`CMFCToolBar::DoPaint`

Repaint une barre d’outils.

virtual void DoPaint(CDC* pDC);

Paramètres

pDC
[in] Pointeur vers un contexte d’appareil.

Notes

Cette méthode est appelée par l’infrastructure lorsqu’une partie de la barre d’outils doit être repeinte.

Remplacez cette méthode pour personnaliser l’apparence d’un objet dérivé de CMFCToolBar.

`CMFCToolBar::DrawButton`

Repaint un bouton de barre d’outils.

virtual BOOL DrawButton(
    CDC* pDC,
    CMFCToolBarButton* pButton,
    CMFCToolBarImages* pImages,
    BOOL bHighlighted,
    BOOL bDrawDisabledImages);

Paramètres

pDC
[in] Pointeur vers un contexte d’appareil.

pButton
[in] Pointeur vers un bouton à dessiner.

pImages
[in] Pointeur vers les images de barre d’outils.

bHighlighted
[in] TRUE si le bouton est mis en surbrillance ; sinon FALSE.

bDrawDisabledImages
[in] TRUE si les boutons désactivés sont grisés ; sinon FALSE.

Valeur de retour

TRUE si le bouton a été repeint ; FALSE si le bouton est masqué.

Notes

La CMFCToolBar::DrawButton méthode appelle cette méthode lorsqu’un bouton de barre d’outils doit être repeint.

Remplacez cette méthode si vous souhaitez personnaliser l’apparence des boutons dans votre barre d’outils.

`CMFCToolBar::DrawSeparator`

Repaint un séparateur dans une barre d’outils.

virtual void DrawSeparator(
    CDC* pDC,
    const CRect& rect,
    BOOL bHorz);

Paramètres

pDC
[in] Pointeur vers un contexte d’appareil.

rect
[in] Rectangle englobant de l’emplacement où le séparateur est dessiné, en pixels.

bHorz
[in] TRUE si le séparateur est horizontal, FALSE si le séparateur est vertical.

Notes

CMFCToolBar::DoPaint appelle cette méthode pour chaque CMFCToolBar::DrawSeparator objet qui a le TBBS_SEPARATOR style, au lieu d’appeler CMFCToolBar::DrawButton ces boutons.

Remplacez cette méthode dans une classe dérivée de CMFCToolBar laquelle personnaliser l’apparence des séparateurs dans la barre d’outils. Les appels CMFCVisualManager::OnDrawSeparator d’implémentation par défaut pour dessiner un séparateur dont l’apparence est déterminée par le gestionnaire de visuels actuel.

`CMFCToolBar::EnableCustomizeButton`

Active ou désactive le bouton Personnaliser qui apparaît dans la barre d’outils.

void EnableCustomizeButton(
    BOOL bEnable,
    int iCustomizeCmd,
    const CString& strCustomizeText,
    BOOL bQuickCustomize=TRUE);

void EnableCustomizeButton(
    BOOL bEnable,
    int iCustomizeCmd,
    UINT uiCustomizeTextResId,
    BOOL bQuickCustomize=TRUE);

Paramètres

bEnable
[in] Active ou désactive le bouton Personnaliser.

iCustomizeCmd
[in] ID de commande du bouton Personnaliser.

strCustomizeText
[in] Étiquette de texte du bouton Personnaliser.

uiCustomizeTextResId
[in] ID de chaîne de ressource de l’étiquette personnaliser le bouton.

bQuickCustomize
[in] Active ou désactive l’option Ajouter ou supprimer des boutons dans le menu qui descend du bouton.

Notes

Si iCustomizeCmd la valeur est -1, l’infrastructure affiche le bouton Personnaliser lorsque plusieurs boutons de barre d’outils ne tiennent pas dans la zone de barre d’outils. Le bouton affiche une double flèche pointant vers la gauche ou un chevron, ce qui indique qu’il y a plus de boutons.

Si iCustomizeCmd elle spécifie un ID de commande valide et bEnable est TRUE, le bouton Personnaliser est toujours affiché. Le bouton a une petite flèche vers le bas et ouvre un menu qui contient une commande. Cette commande utilise l’étiquette de texte spécifiée par strCustomizeText. Si bQuickCustomize c’est également TRUEle cas, le menu affiche l’option Ajouter ou supprimer des boutons.

L’infrastructure ajoute dynamiquement au menu tous les boutons qui ne tiennent pas dans la zone de barre d’outils avant l’élément spécifié par iCustomizeCmd. Le chevron s’affiche en regard de la flèche vers le bas.

`CMFCToolBar::EnableDocking`

Active l’ancrage du volet sur le cadre principal.

virtual void EnableDocking(DWORD dwAlignment);

Paramètres

dwAlignment
[in] Spécifie l’alignement d’ancrage à activer.

Notes

Cette méthode étend l’implémentation de la classe de base, CBasePane::EnableDockingen définissant le membre AFX_CBRS_FLOATde CBasePane::m_dwControlBarStyle données sur . Cette méthode passe dwAlignment ensuite à l’implémentation de classe de base.

`CMFCToolBar::EnableLargeIcons`

Active ou désactive les grandes icônes sur les boutons de barre d’outils.

void EnableLargeIcons(BOOL bEnable);

Paramètres

bEnable
[in] TRUE pour activer les grandes icônes, FALSE pour désactiver les grandes icônes.

Notes

Par défaut, les grandes icônes sont activées.

`CMFCToolBar::EnableQuickCustomization`

Active ou désactive la personnalisation rapide des barres d’outils afin que l’utilisateur puisse appuyer sur la touche Alt et faire glisser un bouton vers un nouvel emplacement.

static void EnableQuickCustomization(BOOL bEnable=TRUE);

Paramètres

bEnable
[in] TRUE pour activer la personnalisation rapide, FALSE pour désactiver la personnalisation rapide.

`CMFCToolBar::EnableReflections`

Active ou désactive la réflexion des commandes.

void EnableReflections(BOOL bEnable = TRUE);

Paramètres

bEnable
[in] TRUE pour activer la réflexion de commande ; FALSE pour désactiver la réflexion de commande.

Notes

Appelez cette méthode pour activer la réflexion de commande pour les boutons de barre d’outils qui contiennent des contrôles incorporés, tels que des zones de liste modifiable.

Pour plus d’informations sur la réflexion des commandes, consultez TN062 : Réflexion des messages pour les contrôles Windows.

`CMFCToolBar::EnableTextLabels`

Active ou désactive les étiquettes de texte sous les images de bouton de barre d’outils.

void EnableTextLabels(BOOL bEnable=TRUE);

Paramètres

bEnable
TRUE si les étiquettes de texte apparaissent sous les images de bouton de barre d’outils ; sinon FALSE.

Notes

Si les étiquettes de texte sont activées, tous les boutons de la barre d’outils sont agrandis pour fournir de l’espace pour que les étiquettes soient affichées sous les images. La boîte de dialogue de personnalisation comporte une case à cocher Afficher l’étiquette de texte dans la page Barres d’outils. Lorsque l’utilisateur sélectionne une barre d’outils et vérifie cette option, l’infrastructure appelle EnableTextLabels la barre d’outils sélectionnée. Vous pouvez désactiver la case à cocher d’un objet dérivé de CMFCToolBar FALSE CMFCToolBar::AllowChangeTextLabels .

`CMFCToolBar::FromHandlePermanent`

Récupère un pointeur vers l’objet CMFCToolBar qui contient le handle de fenêtre donné.

static CMFCToolBar* __stdcall FromHandlePermanent(HWND hwnd);

Paramètres

hwnd
[in] Poignée de fenêtre à rechercher.

Valeur de retour

Pointeur vers l’objet CMFCToolBar qui contient le handle de fenêtre donné, ou NULL s’il n’existe aucun objet correspondant CMFCToolBar .

Notes

Cette méthode partagée examine chaque barre d’outils de l’application pour l’objet CMFCToolBar qui contient le handle de fenêtre donné.

`CMFCToolBar::GetAllButtons`

Renvoie une liste de boutons en lecture seule dans une barre d’outils.

const CObList& GetAllButtons() const;

Valeur de retour

Référence constante à un objet Class, qui contient une collection d’objets CMFCToolBarButton Class.CObList

`CMFCToolBar::GetAllToolbars`

Renvoie une liste en lecture seule de toutes les barres d’outils de l’application.

static const CObList& GetAllToolbars();

Valeur de retour

Référence const à un CObList objet Class qui contient une collection d’objets CMFCToolBar .

`CMFCToolBar::GetBasicCommands`

Renvoie une liste en lecture seule des commandes de base définies dans l’application.

static const CList<UINT,UINT>& GetBasicCommands();

Valeur de retour

Référence const à un CList objet Class qui contient une collection de commandes de base.

Notes

Ajoutez des commandes de base en appelant CMFCToolBar::AddBasicCommand ou CMFCToolBar::SetBasicCommands.

`CMFCToolBar::GetButton`

Retourne un pointeur vers l’objet CMFCToolBarButton Class à un index spécifié.

CMFCToolBarButton* GetButton(int iIndex) const;

Paramètres

iIndex
[in] Spécifie l’index du bouton à retourner.

Valeur de retour

Pointeur vers le bouton de barre d’outils s’il existe ; ou NULL s’il n’y a pas de tel bouton.

`CMFCToolBar::GetButtonInfo`

Retourne l’ID de commande, le style et l’index d’image du bouton à un index spécifié.

void GetButtonInfo(
    int nIndex,
    UINT& nID,
    UINT& nStyle,
    int& iImage) const;

Paramètres

nIndex
[in] Spécifie l’index du bouton dans la liste des boutons de la barre d’outils.

nID
[out] ID de commande d’un bouton.

nStyle
[out] Style du bouton.

iImage
[out] Index de l’image pour le bouton.

Notes

La GetButtonInfo méthode recherche un bouton de barre d’outils à l’index spécifié et récupère l’ID de commande, le style et l’index d’image du bouton.

Si le bouton situé à l’index spécifié n’existe pas, le framework définit nID et nStyle a la valeur 0, et iImage la valeur -1 lorsque la méthode est retournée.

`CMFCToolBar::GetButtonSize`

Retourne les dimensions de chaque bouton de la barre d’outils.

CSize GetButtonSize() const;

Valeur de retour

Objet CSize Class qui spécifie les dimensions de chaque bouton de la barre d’outils.

Notes

Appelez ou CMFCToolBar::SetLockedSizes définissez CMFCToolBar::SetSizes les dimensions de chaque bouton dans la barre d’outils.

`CMFCToolBar::GetButtonStyle`

Retourne le style actuel du bouton de barre d’outils situé à l’index spécifié.

UINT GetButtonStyle(int nIndex) const;

Paramètres

nIndex
[in] Spécifie l’index d’un bouton de barre d’outils.

Valeur de retour

Valeur qui spécifie le style du bouton de barre d’outils. . Consultez Les styles de contrôle ToolBar pour obtenir la liste des styles possibles.

Notes

Appel CMFCToolBar::SetButtonStyle pour définir le style d’un bouton de barre d’outils

`CMFCToolBar::GetButtonText`

Retourne l’étiquette de texte d’un bouton qui a un index spécifié.

CString GetButtonText(int nIndex) const;

void GetButtonText(
    int nIndex,
    CString& rString) const;

`CMFCToolBar::GetCommandButtons`

Retourne une liste de boutons qui ont un ID de commande spécifié à partir de toutes les barres d’outils de l’application.

static int GetCommandButtons(
    UINT uiCmd,
    CObList& listButtons);

Paramètres

uiCmd
[in] ID de commande des boutons.

listButtons
[out] Référence à un CObList objet Class qui reçoit la liste des boutons de barre d’outils.

Valeur de retour

Nombre de boutons qui ont l’ID de commande spécifié.

`CMFCToolBar::GetCount`

Retourne le nombre de boutons et de séparateurs dans la barre d’outils.

int GetCount() const;

Valeur de retour

Nombre de boutons et de séparateurs dans la barre d’outils.

`CMFCToolBar::GetCustomizeButton`

Récupère un pointeur vers l’objet CMFCCustomizeButton associé à la barre d’outils.

CMFCCustomizeButton* GetCustomizeButton();

Valeur de retour

Pointeur vers l’objet CMFCCustomizeButton associé à la barre d’outils.

Notes

Cette méthode récupère le bouton Personnaliser qui apparaît à la fin de la barre d’outils. Utilisez la CMFCToolBar::EnableCustomizeButton méthode pour ajouter le bouton Personnaliser à votre barre d’outils.

Vous pouvez appeler la CMFCToolBar::IsExistCustomizeButton méthode pour déterminer si la barre d’outils contient un objet valide CMFCCustomizeButton .

`CMFCToolBar::GetDefaultImage`

Retourne l’index de l’image par défaut d’un bouton de barre d’outils avec un ID de commande spécifié.

static int GetDefaultImage(UINT uiID);

Paramètres

BOOL GetIgnoreSetText() const;

Valeur de retour

TRUE si les appels pour définir des étiquettes de bouton sont ignorés ; sinon, FALSE.

Notes

`CMFCToolBar::GetImages`

Retourne un pointeur vers la collection d’images de bouton par défaut dans l’application.

static CMFCToolBarImages* GetImages();

Valeur de retour

Pointeur vers l’objet CMFCToolBarImages Class qui contient la collection d’images par défaut pour toutes les barres d’outils de l’application.

Notes

Cette méthode partagée permet d’accéder à la collection de toutes les images de barre d’outils par défaut pour l’application. Appelez la CMFCToolBar::LoadBitmap méthode pour ajouter des images à la collection.

`CMFCToolBar::GetImageSize`

Retourne la taille actuelle des images de bouton de barre d’outils.

CSize GetImageSize() const;

Valeur de retour

Objet CSize Class qui représente la taille actuelle des images de bouton de barre d’outils.

`CMFCToolBar::GetImagesOffset`

Retourne le décalage d’index utilisé pour rechercher les images de bouton de barre d’outils pour cette barre d’outils dans la liste globale des images de bouton de barre d’outils.

int GetImagesOffset() const;

Valeur de retour

Décalage d’index des images de barre d’outils.

Notes

Toutes les images par défaut de la barre d’outils sont stockées dans la liste de classes globaleCMFCToolBarImages. Les images de chaque bouton de la barre d’outils sont stockées consécutivement dans cette liste. Pour calculer l’index de l’image, ajoutez l’index du bouton dans la barre d’outils au décalage du début de la liste des images pour ce bouton de barre d’outils.

Appelez CMFCToolBar::ButtonToIndex pour obtenir l’index d’un bouton de barre d’outils en fonction d’un pointeur vers le bouton.

Appelez CMFCToolBar::GetImages pour obtenir un pointeur vers la collection d’images de barre d’outils.

`CMFCToolBar::GetInvalidateItemRect`

Récupère la région de la zone cliente qui doit être redessinée pour le bouton à l’index donné.

virtual void GetInvalidateItemRect(
    int nIndex,
    LPRECT lpRect) const;

Paramètres

nIndex
[in] Index du bouton pour lequel récupérer la zone cliente.

lpRect
[out] Pointeur vers un RECT objet qui reçoit la région de la zone cliente.

Notes

Le lpRect paramètre ne doit pas être NULL. Si aucun bouton n’existe à l’index fourni, lpRect reçoit un RECT objet initialisé à zéro.

`CMFCToolBar::GetItemID`

Retourne l’ID de commande du bouton de barre d’outils à un index spécifié.

UINT GetItemID(int nIndex) const;

Paramètres

nIndex
[in] Spécifie l’index du bouton de barre d’outils.

Valeur de retour

ID de commande du bouton de la barre d’outils ; ou zéro si le bouton avec l’index spécifié n’existe pas.

`CMFCToolBar::GetItemRect`

Retourne le rectangle englobant du bouton à un index spécifié.

virtual void GetItemRect(
    int nIndex,
    LPRECT lpRect) const;

Paramètres

nIndex
[in] Spécifie l’index d’un bouton de barre d’outils.

lpRect
[out] Pointeur vers CRect un objet qui reçoit les coordonnées du rectangle englobant de l’image.

Notes

Objet CRect sur lequel lpRect les points sont définis sur 0 si un bouton à l’index spécifié n’existe pas.

Exemple

L’exemple suivant montre comment utiliser la GetItemRect méthode de la CMFCToolBar classe. Cet extrait de code fait partie de l’exemple de démonstration IE.

CMFCToolBar m_wndToolBar;

CRect rectToolBar;
m_wndToolBar.GetItemRect(0, &rectToolBar);

`CMFCToolBar::GetLargeColdImages`

Retourne un pointeur vers la collection d’images de bouton de barre d’outils à froid volumineuses dans l’application.

static CMFCToolBarImages* GetLargeColdImages();

Valeur de retour

Pointeur vers la collection d’images froides volumineuses.

Notes

Les images à froid sont les images utilisées lorsque l’utilisateur n’interagit pas avec les boutons de barre d’outils. Appelez CMFCToolBar::LoadBitmapEx pour charger les grandes images froides.

`CMFCToolBar::GetLargeDisabledImages`

Retourne un pointeur vers la collection d’images de bouton de barre d’outils désactivées volumineuses dans l’application.

static CMFCToolBarImages* GetLargeDisabledImages();

Valeur de retour

Pointeur vers la collection d’images de bouton de barre d’outils désactivées volumineuses.

Notes

Les grandes images sont des versions volumineuses des images de bouton de barre d’outils standard. Appelez ou CMFCToolBar::LoadBitmap chargez CMFCToolBar::LoadBitmapEx les grandes images.

`CMFCToolBar::GetLargeImages`

Retourne un pointeur vers la collection d’images de bouton de barre d’outils volumineuses dans l’application.

static CMFCToolBarImages* GetLargeImages();

Valeur de retour

Pointeur vers la collection d’images de bouton de barre d’outils volumineuses.

Notes

Les grandes images sont des versions volumineuses des images de bouton de barre d’outils standard. Appelez CMFCToolBar::LoadBitmapEx pour charger les images volumineuses.

`CMFCToolBar::GetLockedColdImages`

Retourne un pointeur vers la collection d’images froides verrouillées dans la barre d’outils.

CMFCToolBarImages* GetLockedColdImages();

Valeur de retour

Pointeur vers la collection d’images froides verrouillées ou NULL si la barre d’outils n’est pas verrouillée.

Notes

Les images verrouillées sont des versions des images de bouton de barre d’outils standard que l’infrastructure utilise lorsque l’utilisateur ne peut pas personnaliser la barre d’outils. Les images à froid sont les images utilisées lorsque l’utilisateur n’interagit pas avec les boutons de barre d’outils.

Cette méthode retourne NULL si la barre d’outils n’est pas verrouillée. Cette méthode génère également un échec d’assertion dans les builds Debug si la barre d’outils n’est pas verrouillée. Pour plus d’informations sur les barres d’outils verrouillées, consultez CMFCToolBar::IsLocked.

Appelez la CMFCToolBar::LoadBitmapEx méthode pour charger les images froides verrouillées.

`CMFCToolBar::GetLockedDisabledImages`

Retourne un pointeur vers la collection d’images désactivées verrouillées dans la barre d’outils.

CMFCToolBarImages* GetLockedDisabledImages();

Valeur de retour

Pointeur vers la collection d’images désactivées verrouillées ou NULL si la barre d’outils n’est pas verrouillée.

Notes

Les images verrouillées sont des versions des images de bouton de barre d’outils standard que l’infrastructure utilise lorsque l’utilisateur ne peut pas personnaliser la barre d’outils. Les images désactivées sont les images que l’infrastructure utilise lorsqu’un bouton a le TBBS_DISABLED style.

Appelez la CMFCToolBar::LoadBitmapEx méthode pour charger les images désactivées verrouillées.

`CMFCToolBar::GetLockedImages`

Retourne un pointeur vers la collection d’images de bouton verrouillées dans la barre d’outils.

CMFCToolBarImages* GetLockedImages();

Valeur de retour

Pointeur vers la collection d’images de bouton de barre d’outils verrouillées ou NULL si la barre d’outils n’est pas verrouillée.

Notes

Les images verrouillées sont des versions des images de bouton de barre d’outils standard que l’infrastructure utilise lorsque l’utilisateur ne peut pas personnaliser la barre d’outils.

`CMFCToolBar::GetLockedImageSize`

Retourne la taille par défaut des images de barre d’outils verrouillées.

CSize GetLockedImageSize() const;

Valeur de retour

Structure CSize qui spécifie la taille des images de barre d’outils verrouillées ou une structure vide CSize si la barre d’outils n’est pas verrouillée.

Notes

Les images verrouillées sont des versions des images de bouton de barre d’outils standard que l’infrastructure utilise lorsque l’utilisateur ne peut pas personnaliser la barre d’outils.

Cette méthode retourne une CSize structure avec une largeur nulle et une hauteur nulle si la barre d’outils n’est pas verrouillée. Cette méthode génère également un échec d’assertion dans les builds Debug si la barre d’outils n’est pas verrouillée. Pour plus d’informations sur les barres d’outils verrouillées, consultez CMFCToolBar::IsLocked.

Appelez la CMFCToolBar::SetLockedSizes méthode pour spécifier la taille de l’image verrouillée.

`CMFCToolBar::GetLockedMenuImages`

Retourne un pointeur vers la collection d’images de menu de barre d’outils verrouillées dans la barre d’outils.

CMFCToolBarImages* GetLockedMenuImages();

Valeur de retour

Pointeur vers la collection d’images de menu de barre d’outils verrouillées ou NULL si la barre d’outils n’est pas verrouillée.

Notes

Les images verrouillées sont des versions des images de menu de barre d’outils standard utilisées par l’infrastructure lorsque l’utilisateur ne peut pas personnaliser la barre d’outils.

Appelez la CMFCToolBar::LoadBitmapEx méthode pour charger les images de menu verrouillées.

`CMFCToolBar::GetMenuButtonSize`

Retourne la taille des boutons de menu dans l’application.

static CSize GetMenuButtonSize();

Valeur de retour

Objet CSize qui représente la taille des boutons de menu, en pixels.

Notes

La taille des boutons de menu dans les barres d’outils est conservée en tant que variable globale et peut être récupérée par cette méthode statique.

Appel CMFCToolBar::SetMenuSizes pour définir cette variable globale.

`CMFCToolBar::GetMenuImages`

Retourne un pointeur vers la collection d’images de bouton de menu dans l’application.

static CMFCToolBarImages* GetMenuImages();

Valeur de retour

Pointeur vers la collection d’images de menu.

Notes

Appelez la CMFCToolBar::LoadBitmapEx méthode pour charger les images de menu.

Appelez la CMFCToolBar::SetMenuSizes méthode pour définir la taille des boutons et leurs images.

`CMFCToolBar::GetMenuImageSize`

Retourne la taille des images de bouton de menu dans l’application.

static CSize GetMenuImageSize();

Valeur de retour

Objet CSize qui représente la taille des images de menu.

Notes

Cette méthode retourne la taille des images sur les boutons de menu de la barre d’outils qui sont conservés en tant que variable globale. Appel CMFCToolBar::SetMenuSizes pour définir cette variable globale.

`CMFCToolBar::GetOrigButtons`

Récupère la collection de boutons non personnalisés de la barre d’outils.

const CObList& GetOrigButtons() const;

Valeur de retour

Référence à la liste des boutons non personnalisés de la barre d’outils.

Notes

L’infrastructure crée une copie des boutons de barre d’outils avant qu’ils ne soient personnalisés par l’utilisateur. La CMFCToolBar::SetButtons méthode ajoute une copie de chaque bouton dans le tableau fourni à la liste des boutons d’origine. La CMFCToolBar::RestoreOriginalState méthode restaure l’état d’origine de la barre d’outils en le chargeant à partir du fichier de ressources.

Pour définir la liste des boutons d’origine de votre barre d’outils, appelez la CMFCToolBar::SetOrigButtons méthode.

`CMFCToolBar::GetOrigResetButtons`

Récupère la collection de boutons de réinitialisation non personnalisés de la barre d’outils.

const CObList& GetOrigResetButtons() const;

Valeur de retour

Référence à la liste des boutons de réinitialisation non personnalisés de la barre d’outils.

Notes

Lorsque l’utilisateur sélectionne le bouton Réinitialiser pendant le mode de personnalisation, l’infrastructure utilise cette méthode pour restaurer les boutons supprimés de la barre d’outils.

La CMFCToolBar::SetButtons méthode ajoute une copie de chaque bouton de barre d’outils à la liste des boutons de réinitialisation d’origine après avoir appelé la CMFCToolBar::OnReset méthode. Vous pouvez remplacer la CMFCToolBar::OnReset méthode pour personnaliser l’apparence des boutons après que l’utilisateur appuie sur le bouton Réinitialiser .

`CMFCToolBar::GetResourceID`

Récupère l’ID de ressource de la barre d’outils.

UINT GetResourceID() const;

Valeur de retour

ID de ressource de la barre d’outils.

Notes

Appelez la CMFCToolBar::LoadToolBarEx méthode pour définir l’ID de ressource de la barre d’outils.

`CMFCToolBar::GetRouteCommandsViaFrame`

Détermine l’objet, le cadre parent ou le propriétaire, envoie des commandes à la barre d’outils.

BOOL GetRouteCommandsViaFrame();

Valeur de retour

Différent de zéro si le cadre parent envoie des commandes à la barre d’outils ; 0 si le propriétaire envoie des commandes à la barre d’outils.

Notes

Par défaut, le cadre parent envoie des commandes à la barre d’outils. Appelez CMFCToolBar::SetRouteCommandsViaFrame pour modifier ce comportement.

Si cette méthode retourne une valeur différente de zéro, vous pouvez récupérer un pointeur vers l’objet frame parent à l’aide de la CMFCToolBar::GetCommandTarget méthode. Consultez l’exemple VisualStudioDemo pour obtenir un exemple qui utilise cette méthode.

`CMFCToolBar::GetRowHeight`

Retourne la hauteur des boutons de barre d’outils.

virtual int GetRowHeight() const;

Valeur de retour

Hauteur des boutons de barre d’outils, en pixels.

Notes

L’infrastructure appelle cette méthode pour calculer la disposition de la barre d’outils. Remplacez cette méthode dans une classe dérivée pour spécifier une hauteur différente pour votre barre d’outils.

`CMFCToolBar::GetShowTooltips`

Spécifie si les info-bulles sont affichées pour les boutons de barre d’outils.

static BOOL GetShowTooltips();

Valeur de retour

TRUE si les info-bulles sont affichées pour les boutons de barre d’outils ; sinon FALSE.

Notes

Par défaut, les conseils de l’outil sont affichés. Vous pouvez modifier cet indicateur statique en appelant CMFCToolBar::SetShowTooltips.

`CMFCToolBar::GetSiblingToolBar`

Récupère le frère de la barre d’outils.

CMFCToolBar* GetSiblingToolBar();

Valeur de retour

Pointeur vers la barre d’outils frère.

Notes

Pour plus d’informations sur l’activation des boutons Afficher sur une ligne et afficher des boutons sur deux lignes , voir CMFCToolBar::SetSiblingToolBar.

`CMFCToolBar::GetUserImages`

Retourne un pointeur vers la collection d’images de bouton de barre d’outils définies par l’utilisateur dans l’application.

static CMFCToolBarImages* GetUserImages();

Valeur de retour

Pointeur vers la collection d’images de bouton de barre d’outils définies par l’utilisateur pour toutes les barres d’outils de l’application.

Notes

Appelez la CMFCToolBar::SetUserImages méthode pour définir la collection d’images définies par l’utilisateur dans l’application.

`CMFCToolBar::HitTest`

Retourne l’index du bouton de barre d’outils situé à la position spécifiée.

virtual int HitTest(CPoint point);

Paramètres

point
[in] Point à tester, dans les coordonnées du client.

Valeur de retour

Index du bouton situé à la position spécifiée, ou -1 s’il n’y a pas de tel bouton ou si le bouton est un séparateur.

`CMFCToolBar::InsertButton`

Insère un bouton dans la barre d’outils.

virtual int InsertButton(
    const CMFCToolBarButton& button,
    INT_PTR iInsertAt=-1);

virtual int InsertButton(
    CMFCToolBarButton* pButton,
    int iInsertAt=-1);

Paramètres

button
[in] Spécifie le bouton à insérer.

iInsertAt
[in] Spécifie la position de base zéro à laquelle insérer le bouton.

Valeur de retour

Position à laquelle le bouton a été inséré ou -1 si une erreur se produit.

Notes

Si iInsertAt la valeur est -1, cette méthode ajoute le bouton à la fin de la liste des boutons de barre d’outils.

Appelez la CMFCToolBar::InsertSeparator méthode pour insérer un séparateur dans la barre d’outils.

`CMFCToolBar::InsertSeparator`

Insère un séparateur dans la barre d’outils.

virtual int InsertSeparator(INT_PTR iInsertAt=-1);

Paramètres

iInsertAt
[in] Spécifie la position de base zéro à laquelle insérer le séparateur. Ce paramètre doit être supérieur à 0.

Valeur de retour

Position à laquelle le séparateur a été inséré ou -1 si une erreur se produit.

Notes

Appelez cette méthode pour insérer un séparateur entre deux boutons existants. Si iInsertAt la valeur est -1, cette méthode ajoute le séparateur à la fin de la liste des boutons de barre d’outils.

Vous ne pouvez pas utiliser cette méthode pour ajouter un séparateur à une barre d’outils vide.

Appelez la CMFCToolBar::InsertButton méthode pour insérer un bouton dans la barre d’outils.

`CMFCToolBar::InvalidateButton`

Invalide la zone cliente du bouton de barre d’outils qui existe à l’index fourni.

CMFCToolBarButton* InvalidateButton(int nIndex);

Paramètres

nIndex
[in] Index de base zéro du bouton dans la barre d’outils.

Valeur de retour

Pointeur vers l’objet CMFCToolBarButton qui existe à l’index fourni ou NULL s’il n’existe aucun objet de ce type.

Notes

L’infrastructure appelle cette méthode lorsqu’elle met à jour la zone cliente associée à un bouton de barre d’outils. Il appelle la CWnd::InvalidateRect méthode avec le rectangle client de l’objet CMFCToolBarButton qui existe à l’index fourni.

`CMFCToolBar::IsAddRemoveQuickCustomize`

Détermine si un utilisateur peut ajouter ou supprimer des boutons de barre d’outils à l’aide de l’option Personnaliser le menu.

BOOL IsAddRemoveQuickCustomize();

Valeur de retour

TRUEsi un utilisateur peut utiliser l’option Personnaliser le menu pour modifier la barre d’outils ; sinon, FALSE.

Notes

`CMFCToolBar::IsAltCustomizeMode`

Spécifie si la personnalisation rapide est utilisée pour faire glisser un bouton. Lorsque la personnalisation rapide est activée, un utilisateur peut appuyer longuement sur la touche Alt et faire glisser un bouton vers un nouvel emplacement.

static BOOL __stdcall IsAltCustomizeMode();

Valeur de retour

TRUE si la personnalisation rapide est utilisée pour faire glisser un bouton ; sinon, FALSE.

Notes

`CMFCToolBar::IsAutoGrayInactiveImages`

Spécifie si la génération automatique d’images de bouton inactives (non mises en surbrillance) est activée.

static BOOL IsAutoGrayInactiveImages();

Valeur de retour

TRUE si l’option permettant de désactiver automatiquement les images inactives est activée ; sinon FALSE.

Notes

Vous pouvez activer ou désactiver la grisage automatique des images inactives en appelant CMFCToolBar::AutoGrayInactiveImages.

`CMFCToolBar::IsBasicCommand`

Détermine si une commande figure dans la liste des commandes de base.

static BOOL IsBasicCommand(UINT uiCmd);

Paramètres

uiCmd
[in] Spécifie la commande à vérifier.

Valeur de retour

TRUE si la commande spécifiée appartient à la liste des commandes de base ; sinon FALSE.

Notes

Cette méthode statique détermine si la commande spécifiée par uiCmd appartient à la liste globale des commandes de base. Vous pouvez modifier la liste des commandes de base en appelant CMFCToolBar::AddBasicCommand ou CMFCToolBar::SetBasicCommands.

`CMFCToolBar::IsButtonExtraSizeAvailable`

Détermine si la barre d’outils peut afficher des boutons qui ont des bordures étendues.

virtual BOOL IsButtonExtraSizeAvailable() const;

Valeur de retour

TRUE si la barre peut afficher des boutons avec la taille de bordure supplémentaire ; sinon FALSE.

Notes

L’objet de barre d’outils retourne TRUE s’il peut afficher des boutons qui ont des bordures étendues. Un bouton de barre d’outils appelle cette méthode lorsqu’elle gère la CMFCToolBarButton::OnChangeParentWnd notification et définit son indicateur de taille de bordure supplémentaire interne en conséquence. Cet indicateur interne peut être récupéré ultérieurement en appelant CMFCToolBarButton::IsExtraSize.

Remplacez cette méthode dans une classe dérivée et CMFCToolBar retournez TRUE si votre barre peut afficher les boutons de barre d’outils avec la taille de bordure supplémentaire et retourner FALSE sinon. L'implémentation par défaut retourne la valeur TRUE.

`CMFCToolBar::IsButtonHighlighted`

Détermine si le bouton spécifié est mis en surbrillance.

BOOL IsButtonHighlighted(int iButton) const;

Paramètres

iButton
[in] Spécifie l’index d’un bouton de barre d’outils.

Valeur de retour

TRUE si le bouton spécifié est mis en surbrillance ; sinon, FALSE.

Notes

`CMFCToolBar::IsCommandPermitted`

Détermine si une commande est autorisée.

static BOOL IsCommandPermitted(UINT uiCmd);

Paramètres

uiCmd
[in] Spécifie la commande à vérifier.

Valeur de retour

TRUE si la commande spécifiée est autorisée ; sinon FALSE.

Notes

Cette méthode statique détermine si la commande spécifiée par uiCmd appartient à la liste globale des commandes non autorisées.

Vous pouvez modifier la liste des commandes non autorisées en appelant CMFCToolBar::SetNonPermittedCommands.

`CMFCToolBar::IsCommandRarelyUsed`

Détermine si une commande est rarement utilisée.

static BOOL IsCommandRarelyUsed(UINT uiCmd);

Paramètres

uiCmd
[in] Spécifie la commande à vérifier.

Valeur de retour

TRUE si la commande spécifiée est rarement utilisée ; sinon FALSE.

Notes

La IsCommandRarelyUsed méthode retourne FALSE lorsqu’une ou plusieurs des conditions suivantes se produisent :

La commande spécifiée appartient à la liste des commandes de base
La commande spécifiée est l’une des commandes standard
L’infrastructure est en mode de personnalisation
La liste des commandes de base est vide
Plus de 20 % des appels de commandes sont des appels à la commande spécifiée.

`CMFCToolBar::IsCustomizeMode`

Spécifie si l’infrastructure de barre d’outils est en mode de personnalisation.

static BOOL IsCustomizeMode();

Valeur de retour

TRUE si l’infrastructure est en mode de personnalisation ; sinon FALSE.

Notes

Vous pouvez activer le mode de personnalisation en appelant CMFCToolBar::SetCustomizeMode.

L’infrastructure change le mode lorsque l’utilisateur appelle la boîte de dialogue de personnalisation ( CMFCToolBarsCustomizeDialog classe).

`CMFCToolBar::IsDragButton`

Détermine si un bouton de barre d’outils est déplacé.

BOOL IsDragButton(const CMFCToolBarButton* pButton) const;

Paramètres

pButton
[in] Pointeur vers un bouton de barre d’outils.

Valeur de retour

TRUE si le bouton spécifié est déplacé ; sinon, FALSE.

Notes

`CMFCToolBar::IsExistCustomizeButton`

Détermine si la barre d’outils contient le bouton Personnaliser .

BOOL IsExistCustomizeButton();

Valeur de retour

TRUE si la barre d’outils contient le bouton Personnaliser ; sinon FALSE.

Notes

Si cette méthode retourne, la CMFCToolBar::GetCustomizeButton méthode renvoie TRUEun pointeur vers le bouton Personnaliser qui apparaît à la fin de la barre d’outils.

Utilisez la CMFCToolBar::EnableCustomizeButton méthode pour ajouter le bouton Personnaliser à votre barre d’outils.

`CMFCToolBar::IsFloating`

Détermine si la barre d’outils est flottante.

virtual BOOL IsFloating() const;

Valeur de retour

TRUE si la barre d’outils est flottante ; sinon, FALSE.

`CMFCToolBar::IsLargeIcons`

Spécifie si les barres d’outils de l’application affichent actuellement de grandes icônes.

static BOOL IsLargeIcons();

Valeur de retour

TRUE si l’application utilise des icônes volumineuses ; sinon FALSE.

Notes

Appelez CMFCToolBar::SetLargeIcons à basculer entre les grandes icônes et les icônes régulières.

L’infrastructure change automatiquement le mode lorsque l’utilisateur bascule la case à cocher Grandes icônes dans la page Options de la boîte de dialogue Personnalisation .

`CMFCToolBar::IsLastCommandFromButton`

Détermine si la commande la plus récente exécutée a été envoyée à partir du bouton de barre d’outils spécifié.

static BOOL IsLastCommandFromButton(CMFCToolBarButton* pButton);

Paramètres

pButton
[in] Pointeur vers le bouton.

Valeur de retour

TRUE si la dernière commande a été envoyée à partir du bouton qui pButton spécifie ; sinon FALSE.

Notes

Cette méthode obtient un pointeur vers une MSG structure en appelant CWnd::GetCurrentMessage. Il compare ensuite le HWND bouton avec les membres et MSG::hwnd les MSG::lParam membres pour déterminer si le bouton était la source de la commande.

`CMFCToolBar::IsLocked`

Détermine si la barre d’outils est verrouillée.

BOOL IsLocked() const;

Valeur de retour

TRUE si la barre d’outils est verrouillée ; sinon, FALSE.

Notes

Cette méthode retourne TRUE lorsque l’utilisateur ne peut pas effectuer de tâches de personnalisation telles que le repositionnement des boutons de barre d’outils.

Les barres d’outils verrouillées utilisent des listes d’images distinctes. Pour plus d’informations sur ces listes d’images, consultez CMFCToolBar::LoadBitmapEx.

`CMFCToolBar::IsOneRowWithSibling`

Détermine si la barre d’outils et sa barre d’outils frère sont positionnées sur la même ligne.

BOOL IsOneRowWithSibling();

Valeur de retour

TRUE si la barre d’outils et son frère sont positionnés sur la même ligne ; sinon FALSE.

Notes

La CMFCCustomizeButton::CreatePopupMenu méthode appelle cette méthode pour déterminer comment afficher le menu contextuel Personnaliser . Si cette méthode est retournée TRUE, l’infrastructure affiche les boutons Afficher sur un bouton Ligne . Sinon, l’infrastructure affiche les boutons Afficher sur deux lignes .

En règle générale, vous n'avez pas à utiliser cette méthode. Pour activer les boutons Afficher sur une seule ligne ou afficher les boutons sur deux boutons Lignes , appelez CMFCToolBar::SetSiblingToolBar.

`CMFCToolBar::IsResourceChanged`

virtual BOOL IsResourceChanged() const;

Valeur de retour

Notes

`CMFCToolBar::IsSibling`

BOOL IsSibling();

Valeur de retour

Notes

`CMFCToolBar::IsUserDefined`

Spécifie si la barre d’outils est définie par l’utilisateur.

BOOL IsUserDefined() const;

Valeur de retour

TRUE si la barre d’outils a été créée par l’utilisateur ; sinon FALSE.

`CMFCToolBar::LoadBitmap`

Charge les images de barre d’outils à partir des ressources de l’application.

virtual BOOL LoadBitmap(
    UINT uiResID,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    BOOL bLocked=FALSE,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0);

Paramètres

uiResID
[in] ID de ressource de la bitmap qui fait référence aux images de barre d’outils chaudes.

uiColdResID
[in] ID de ressource de la bitmap qui fait référence aux images de barre d’outils à froid.

uiMenuResID
[in] ID de ressource de la bitmap qui fait référence aux images de menu standard.

bLocked
[in] TRUE pour verrouiller la barre d’outils ; sinon FALSE.

uiDisabledResID
[in] ID de ressource de la bitmap qui fait référence aux images de barre d’outils désactivées.

uiMenuDisabledResID
[in] ID de ressource de la bitmap qui fait référence aux images de menu désactivées.

Valeur de retour

Différent de zéro si la méthode réussit ; sinon, 0.

Notes

La CMFCToolBar::LoadToolBarEx méthode appelle cette méthode pour charger les images associées à la barre d’outils. Surchargez cette méthode pour effectuer un chargement personnalisé des ressources d’images.

Appelez la méthode LoadBitmapEx pour charger des images supplémentaires après avoir créé la barre d’outils.

`CMFCToolBar::LoadBitmapEx`

virtual BOOL LoadBitmapEx(
    CMFCToolBarInfo& params,
    BOOL bLocked = FALSE);

Paramètres

[in] params
[in] bLocked\

Valeur de retour

Notes

`CMFCToolBar::LoadLargeIconsState`

static BOOL __stdcall LoadLargeIconsState(LPCTSTR lpszProfileName = NULL);

Paramètres

[in] lpszProfileName\

Valeur de retour

Notes

`CMFCToolBar::LoadParameters`

Charge les options de barre d’outils globales à partir du Registre Windows.

static BOOL LoadParameters(LPCTSTR lpszProfileName=NULL);

Paramètres

lpszProfileName
[in] Spécifie le chemin relatif de la clé de Registre Windows.

Valeur de retour

Différent de zéro si la méthode réussit ; sinon, 0.

Notes

Cette méthode charge des paramètres globaux tels que le type d’animation de menu, le style d’ombre du menu et l’affichage d’icônes volumineuses à partir du Registre Windows.

La CWinAppEx::LoadState méthode appelle cette méthode dans le cadre du processus d’initialisation de l’application.

`CMFCToolBar::LoadState`

Charge les informations d’état de la barre d’outils à partir du Registre Windows.

virtual BOOL LoadState(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Paramètres

lpszProfileName
[in] Spécifie le chemin relatif de la clé de Registre Windows.

nIndex
[in] Spécifie l’ID de contrôle de la barre d’outils.

uiID
[in] Spécifie l’ID de ressource de la barre d’outils.

Valeur de retour

Différent de zéro si la méthode réussit ; sinon, 0.

Notes

L’infrastructure appelle cette méthode dans le cadre du processus d’initialisation de l’application. Pour plus d’informations, consultez CWinAppEx::LoadState.

`CMFCToolBar::LoadToolBar`

Charge la barre d’outils à partir des ressources d’application.

virtual BOOL LoadToolBar(
    UINT uiResID,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    BOOL bLocked=FALSE,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0,
    UINT uiHotResID=0);

Paramètres

uiResID
[in] ID de ressource de la barre d’outils.

uiColdResID
[in] ID de ressource de la bitmap qui fait référence aux images de barre d’outils à froid.

uiMenuResID
[in] ID de ressource de la bitmap qui fait référence aux images de menu standard.

bLocked
[in] Valeur booléenne qui spécifie si la barre d’outils est verrouillée ou non. Si ce paramètre est TRUEle cas, la barre d’outils est verrouillée. Sinon, la barre d’outils n’est pas verrouillée.

uiDisabledResID
[in] ID de ressource de la bitmap qui fait référence aux images de barre d’outils désactivées.

uiMenuDisabledResID
[in] ID de ressource de la bitmap qui fait référence aux images de menu désactivées.

uiHotResID
[in] ID de ressource de la bitmap qui fait référence aux images de barre d’outils chaudes.

Valeur de retour

Différent de zéro si la méthode réussit ; sinon, 0.

Notes

L’infrastructure appelle cette méthode pendant l’initialisation pour charger les images associées à la barre d’outils.

Exemple

L’exemple suivant montre comment utiliser la LoadToolBar méthode dans la CMFCToolBar classe. Cet extrait de code fait partie de l’exemple de démonstration IE.

CMFCToolBar m_wndToolBar;

// The this pointer points to CMainFrame class which extends the CFrameWnd class.
if (!m_wndToolBar.CreateEx(this, TBSTYLE_TRANSPARENT) ||
    !m_wndToolBar.LoadToolBar(IDR_MAINFRAME, uiToolbarColdID, uiMenuID,
                              FALSE /* Not locked */, 0, 0, uiToolbarHotID))
{
   TRACE0("Failed to create toolbar\n");
   return -1; // fail to create
}

`CMFCToolBar::LoadToolBarEx`

Charge la barre d’outils à partir des ressources d’application à l’aide de la CMFCToolBarInfo classe d’assistance pour permettre à l’application d’utiliser des images volumineuses.

virtual BOOL LoadToolBarEx(
    UINT uiToolbarResID,
    CMFCToolBarInfo& params,
    BOOL bLocked=FALSE);

Paramètres

uiToolbarResID
[in] ID de ressource de la barre d’outils.

params
[in] Référence à un CMFCToolBarInfo objet qui contient les ID de ressource pour les images de barre d’outils.

bLocked
[in] Valeur booléenne qui spécifie si la barre d’outils est verrouillée ou non. Si ce paramètre est TRUEle cas, la barre d’outils est verrouillée. Sinon, la barre d’outils n’est pas verrouillée.

Valeur de retour

Différent de zéro si la méthode réussit ; sinon, 0.

Notes

Appelez cette méthode pour charger des images de barre d’outils à partir des ressources de l’application.

`CMFCToolBar::m_dblLargeImageRatio`

Spécifie le rapport entre la dimension (hauteur ou largeur) des images volumineuses et la dimension des images régulières.

AFX_IMPORT_DATA static double m_dblLargeImageRatio;

Notes

Le ratio par défaut est 2. Vous pouvez modifier cette valeur pour agrandir ou réduire les images de barre d’outils volumineuses.

L’infrastructure utilise ce membre de données lorsque vous ne spécifiez pas d’ensemble d’images volumineuses. Par exemple, si vous fournissez uniquement l’ensemble de petites images avec une taille de 16 x 16 et que les grandes images doivent avoir la taille 24 x 24, définissez ce membre de données sur 1,5.

`CMFCToolBar::NextMenu`

virtual BOOL NextMenu();

Valeur de retour

Notes

`CMFCToolBar::OnBeforeRemoveButton`

virtual BOOL OnBeforeRemoveButton(
    CMFCToolBarButton* pButton,
    DROPEFFECT dropEffect);

Paramètres

pButton
[in] Inutilisé.

dropEffect
[in] Inutilisé.

Valeur de retour

Notes

`CMFCToolBar::OnChangeHot`

Appelé par l’infrastructure lorsqu’un utilisateur sélectionne un bouton dans la barre d’outils.

virtual void OnChangeHot(int iHot);

Paramètres

iHot
[in] Spécifie l’index du bouton de barre d’outils sélectionné ; ou -1 si aucun bouton de barre d’outils n’est sélectionné.

Notes

Remplacez cette méthode pour traiter les notifications que l’utilisateur a sélectionné un bouton dans une barre d’outils.

`CMFCToolBar::OnChangeVisualManager`

virtual void OnChangeVisualManager();

Notes

`CMFCToolBar::OnFillBackground`

Appelé par l’infrastructure pour remplir l’arrière-plan de CBasePane::DoPaint la barre d’outils.

virtual void OnFillBackground(CDC* pDC);

Paramètres

pDC
[in] Pointeur vers un contexte d’appareil.

Notes

CMFCToolBar::DoPaint appelle cette méthode lorsque l’arrière-plan d’une barre d’outils a été rempli. L'implémentation par défaut n'exécute aucune opération.

Remplacez cette méthode pour dessiner un arrière-plan personnalisé dans des classes dérivées.

`CMFCToolBar::OnGlobalFontsChanged`

virtual void OnGlobalFontsChanged();

Notes

`CMFCToolBar::OnReset`

Restaure la barre d’outils à son état d’origine.

virtual void OnReset();

Notes

Remplacez cette méthode pour gérer la notification concernant une réinitialisation de barre d’outils.

L'implémentation par défaut n'exécute aucune opération. Remplacez OnReset dans une classe dérivée du moment où CMFCToolBar la barre d’outils comporte des boutons factices qui doivent être remplacés lorsque la barre d’outils retourne à son état d’origine.

`CMFCToolBar::OnSetAccData`

virtual BOOL OnSetAccData(long lVal);

Paramètres

[in] lVal\

Valeur de retour

Notes

`CMFCToolBar::OnSetDefaultButtonText`

Restaure le texte d’un bouton de barre d’outils à son état par défaut.

virtual BOOL OnSetDefaultButtonText(CMFCToolBarButton* pButton);

Paramètres

pButton
[in] Pointe vers un bouton dont le texte est défini.

Valeur de retour

TRUE si le texte a été restauré avec succès ; sinon FALSE.

Notes

Remplacez cette méthode pour traiter les notifications que le texte d’un bouton de barre d’outils est en cours de modification par défaut.

L’implémentation par défaut charge le texte d’un bouton à partir des ressources de l’application.

`CMFCToolBar::OnUserToolTip`

Appelé par l’infrastructure lorsque l’info-bulle d’un bouton est sur le point d’être affichée.

virtual BOOL OnUserToolTip(
    CMFCToolBarButton* pButton,
    CString& strTTText) const;

Paramètres

pButton
[in] Pointe vers un bouton de barre d’outils pour lequel une info-bulle doit être affichée.

strTTText
[out] Référence à l’objet CString qui reçoit le texte de l’info-bulle.

Valeur de retour

TRUE si strTTText elle a été remplie avec du texte d’info-bulle ; sinon FALSE.

Notes

L’infrastructure appelle cette méthode lorsque l’info-bulle d’un bouton de barre d’outils est sur le point d’être affichée. Si OnUserToolTip elle est retournéeTRUE, l’infrastructure affiche une info-bulle qui contient le texte retourné par OnUserToolTip .strTTText Sinon, l’info-bulle contient le texte du bouton.

Remplacez OnUserToolTip pour personnaliser les info-bulles des boutons de barre d’outils. Appels d’implémentation CMFCToolBar::OnUserToolTip par défaut pour obtenir le texte de l’info-bulle.

`CMFCToolBar::PrevMenu`

virtual BOOL PrevMenu();

Valeur de retour

Notes

`CMFCToolBar::ProcessCommand`

Publie un WM_COMMAND message dans la fenêtre qui possède la barre d’outils.

BOOL ProcessCommand(CMFCToolBarButton* pButton);

Paramètres

pButton
[in] Pointeur vers un bouton de la barre d’outils.

Valeur de retour

Cette méthode doit toujours retourner TRUE. MFC utilise des FALSE valeurs en interne.

Notes

Cette méthode publie un WM_COMMAND message dans la fenêtre propriétaire de la barre d’outils en appelant CWnd::PostMessage et en passant l’ID de commande du bouton spécifié en tant que wParam paramètre.

Utilisez la ON_COMMAND macro pour mapper le WM_COMMAND message à une fonction membre.

`CMFCToolBar::RemoveAllButtons`

Supprime tous les boutons et séparateurs de la barre d’outils.

virtual void RemoveAllButtons();

Notes

L’infrastructure appelle cette méthode lorsqu’elle recrée ou détruit une barre d’outils.

`CMFCToolBar::RemoveButton`

Supprime de la barre d’outils le bouton qui a l’index spécifié.

virtual BOOL RemoveButton(int iIndex);

Paramètres

iIndex
[in] Spécifie l’index de base zéro du bouton à supprimer.

Valeur de retour

TRUE si la méthode réussit, ou FALSE si l’index spécifié n’est pas valide ou si l’index fait référence au bouton Personnaliser .

Notes

Cette méthode met à jour des attributs de barre d’outils supplémentaires affectés par la suppression du bouton. Par exemple, cette méthode supprime les séparateurs nonessentials de la barre d’outils et reconstruit la table des touches de raccourci.

Pour plus d’informations sur le bouton Personnaliser , consultez CMFCToolBar::EnableCustomizeButton.

`CMFCToolBar::RemoveStateFromRegistry`

Supprime les informations d’état de la barre d’outils du Registre Windows.

virtual BOOL RemoveStateFromRegistry(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Paramètres

lpszProfileName
[in] Spécifie la clé de Registre où se trouvent les informations d’état.

nIndex
[in] ID de contrôle de la barre d’outils.

uiID
[in] ID de ressource de la barre d’outils. Si ce paramètre est -1, cette méthode utilise la CWnd::GetDlgCtrlID méthode pour récupérer l’ID de ressource.

Valeur de retour

Différent de zéro si la méthode réussit ; sinon, 0.

Notes

L’infrastructure appelle cette méthode lorsqu’elle supprime une barre d’outils définie par l’utilisateur.

Remplacez cette méthode si vous stockez des informations d’état supplémentaires dans le Registre Windows.

`CMFCToolBar::ReplaceButton`

Remplace un bouton de barre d’outils par un autre bouton de barre d’outils.

int ReplaceButton(
    UINT uiCmd,
    const CMFCToolBarButton& button,
    BOOL bAll=FALSE);

Paramètres

uiCmd
[in] ID de commande du bouton à remplacer.

button
[in] Référence à l’insertion CMFCToolBarButton .

bAll
[in] Valeur booléenne qui spécifie s’il faut remplacer tous les boutons dont l’ID de commande est spécifié par uiCmd. Si ce paramètre est TRUE, tous les boutons qui ont l’ID de commande spécifié sont remplacés. Sinon, le premier bouton est remplacé.

Valeur de retour

Nombre de boutons remplacés. Cette méthode retourne 0 si un bouton avec l’ID de commande spécifié n’existe pas dans la barre d’outils.

Notes

Appelez cette méthode lorsque vous souhaitez ajouter des boutons de barre d’outils qui ne peuvent pas être chargés à partir de ressources. Vous pouvez créer un bouton d’espace réservé au moment du design et remplacer ce bouton par un bouton personnalisé lorsque vous initialisez la barre d’outils. Consultez l’exemple VisualStudioDemo pour obtenir un exemple qui utilise cette méthode.

Exemple

L’exemple suivant montre comment utiliser la ReplaceButton méthode dans la CMFCToolBar classe. Cet extrait de code fait partie de l’exemple de démonstration IE.

CMFCToolBar m_wndToolBar;

// CMenu menuHistory
// CString str
m_wndToolBar.ReplaceButton(ID_GO_BACK,
                           CMFCToolBarMenuButton(ID_GO_BACK, menuHistory,
                                                 GetCmdMgr()->GetCmdImage(ID_GO_BACK), str));

`CMFCToolBar::ResetAll`

Restaure toutes les barres d’outils à leurs états d’origine.

static void __stdcall ResetAll();

Notes

Cette méthode appelle la CMFCToolBar::RestoreOriginalState méthode sur chaque barre d’outils de l’application qui peut être restaurée. Il utilise la CMFCToolBar::CanBeRestored méthode pour déterminer si une barre d’outils peut être restaurée.

`CMFCToolBar::ResetAllImages`

Efface toutes les collections d’images de barre d’outils dans l’application.

static void __stdcall ResetAllImages();

Notes

Cette méthode efface les collections d’images initialisées par les méthodes et CMFCToolBar::LoadBitmap les CMFCToolBar::LoadToolBar méthodes.

`CMFCToolBar::ResetImages`

virtual void ResetImages();

Notes

`CMFCToolBar::RestoreFocus`

virtual void RestoreFocus();

Notes

`CMFCToolBar::RestoreOriginalState`

Restaure l'état initial d'une barre d'outils.

virtual BOOL RestoreOriginalState();

Valeur de retour

TRUE si la méthode réussit, ou FALSE si la méthode échoue ou si la barre d’outils est définie par l’utilisateur.

Notes

Cette méthode charge la barre d’outils à partir du fichier de ressources à l’aide de la CMFCToolBar::LoadToolBar méthode.

L’infrastructure appelle cette méthode lorsque l’utilisateur choisit le bouton Réinitialiser tout dans la page Barres d’outils d’une boîte de dialogue de personnalisation.

`CMFCToolBar::SaveParameters`

static BOOL __stdcall SaveParameters(LPCTSTR lpszProfileName = NULL);

Paramètres

[in] lpszProfileName\

Valeur de retour

Notes

`CMFCToolBar::SaveState`

Enregistre les informations d’état de la barre d’outils dans le Registre Windows.

virtual BOOL SaveState(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Paramètres

lpszProfileName
[in] Spécifie le chemin relatif de la clé de Registre Windows.

nIndex
[in] ID de contrôle de la barre d’outils.

uiID
[in] ID de ressource de la barre d’outils.

Valeur de retour

Différent de zéro si la méthode réussit ; sinon, 0.

Notes

L’infrastructure appelle cette méthode lorsqu’elle enregistre l’état de l’application dans le Registre. Pour plus d’informations, consultez CWinAppEx::SaveState.

`CMFCToolBar::SetBasicCommands`

Définit la liste des commandes qui sont toujours affichées lorsqu’un utilisateur ouvre un menu.

static void __stdcall SetBasicCommands(CList<UINT,UINT>& lstCommands);

Paramètres

lstCommands
[in] Référence à un CList objet qui contient une collection de commandes.

Notes

Une commande de base est toujours affichée lorsque le menu est ouvert. Cette méthode est significative lorsque l’utilisateur choisit d’afficher les commandes récemment utilisées.

Utilisez la CMFCToolBar::AddBasicCommand méthode pour ajouter une commande à la liste des commandes de base. Utilisez la CMFCToolBar::GetBasicCommands méthode pour récupérer la liste des commandes de base utilisées par votre application.

Consultez l’exemple d’Explorateur pour obtenir un exemple qui utilise cette méthode.

`CMFCToolBar::SetButtonInfo`

Définit l’ID de commande, le style et l’ID d’image d’un bouton de barre d’outils.

void SetButtonInfo(
    int nIndex,
    UINT nID,
    UINT nStyle,
    int iImage);

Paramètres

nIndex
[in] Index de base zéro du bouton dont les propriétés sont définies.

nID
[in] ID de commande du bouton.

nStyle
[in] Style du bouton. Consultez Les styles de contrôle ToolBar pour obtenir la liste des styles de bouton de barre d’outils disponibles.

iImage
[in] Index d’image de base zéro du bouton (c’est-à-dire l’index dans la collection d’images de barre d’outils).

Notes

Appelez cette méthode pour définir les propriétés d’un bouton de barre d’outils.

Dans les builds Debug, cette méthode génère un échec d’assertion si l’index spécifié par nIndex n’est pas valide.

Appelez la CMFCToolBar::SetButtonStyle méthode pour définir uniquement le style du bouton.

`CMFCToolBar::SetButtons`

Définit les boutons de la barre d’outils.

virtual BOOL SetButtons(
    const UINT* lpIDArray,
    int nIDCount,
    BOOL bRemapImages=TRUE);

Paramètres

lpIDArray
[in] Pointeur vers le tableau d’ID de commandes des boutons à insérer.

nIDCount
[in] Nombre d’éléments dans lpIDArray.

bRemapImages
[in] Valeur booléenne qui spécifie s’il faut associer les images de bouton existantes aux boutons insérés. Si ce paramètre est TRUE, les images sont remappées.

Valeur de retour

Différent de zéro si la méthode réussit ; sinon, 0.

Notes

Appelez cette méthode pour supprimer les boutons existants d’une barre d’outils et insérer une collection de nouveaux boutons.

Cette méthode ajoute le bouton Personnaliser à la barre d’outils et envoie le AFX_WM_RESETTOOLBAR message à la fenêtre parente de la barre d’outils. Pour plus d’informations sur le bouton Personnaliser , consultez CMFCToolBar::EnableCustomizeButton.

`CMFCToolBar::SetButtonStyle`

Définit le style du bouton de barre d’outils à l’index donné.

virtual void SetButtonStyle(
    int nIndex,
    UINT nStyle);

Paramètres

nIndex
[in] Index de base zéro du bouton de barre d’outils dont le style doit être défini.

nStyle
[in] Style du bouton. Consultez Les styles de contrôle ToolBar pour obtenir la liste des styles de bouton de barre d’outils disponibles.

Notes

Cette méthode supprime le TBBS_PRESSED style si nStyle c’est TBBS_DISABLED parce que l’utilisateur ne peut pas sélectionner un bouton désactivé.

`CMFCToolBar::SetButtonText`

Définit l’étiquette de texte d’un bouton de barre d’outils.

BOOL SetButtonText(
    int nIndex,
    LPCTSTR lpszText);

Paramètres

nIndex
[in] Index du bouton de barre d’outils.

lpszText
[in] Étiquette de texte du bouton de la barre d’outils. Ne doit pas avoir la valeur Null.

Valeur de retour

TRUE si la méthode réussit ; sinon FALSE.

Notes

Cette méthode retourne FALSE si l’index fourni ne fait pas référence à un bouton de barre d’outils valide.

`CMFCToolBar::SetCommandUsageOptions`

Spécifie quand les commandes rarement utilisées n’apparaissent pas dans le menu de l’application.

static BOOL SetCommandUsageOptions(
    UINT nStartCount,
    UINT nMinUsagePercentage=5);

Paramètres

nStartCount
[in] Spécifie le nombre de fois où les commandes doivent être exécutées avant que l’infrastructure affiche uniquement les commandes de base et récemment utilisées.

nMinUsagePercentage
[in] Pourcentage de fois où une commande doit être exécutée pour être considérée comme une commande récemment utilisée.

Valeur de retour

FALSE si nMinUsagePercentage elle est égale ou supérieure à 100 ; sinon TRUE.

Notes

Appelez cette méthode pour personnaliser l’algorithme utilisé par l’infrastructure pour déterminer l’apparence des éléments de menu de base et récemment utilisés. Pour plus d’informations sur les commandes de base, consultez CMFCToolBar::AddBasicCommand.

Cette classe utilise la CMFCCmdUsageCount classe pour suivre le nombre d’utilisations des commandes. Pour plus d’informations sur cette classe, consultez CMFCCmdUsageCount Classe.

`CMFCToolBar::SetCustomizeMode`

Active ou désactive le mode de personnalisation pour toutes les barres d’outils de l’application.

static BOOL __stdcall SetCustomizeMode(BOOL bSet=TRUE);

Paramètres

bSet
[in] Valeur booléenne qui spécifie s’il faut activer ou désactiver le mode de personnalisation. Définissez ce paramètre pour TRUE activer le mode de personnalisation ou FALSE pour le désactiver.

Valeur de retour

TRUE si l’appel de cette méthode modifie le mode de personnalisation ; sinon FALSE.

Notes

Cette méthode ajuste la disposition et redessine chaque barre d’outils de l’application. Appelez la CMFCToolBar::IsCustomizeMode méthode pour déterminer si l’application est en mode de personnalisation,

`CMFCToolBar::SetGrayDisabledButtons`

Spécifie si les boutons indisponibles de la barre d’outils sont grisés ou si les images indisponibles par bouton sont utilisées.

void SetGrayDisabledButtons(BOOL bGrayDisabledButtons);

Paramètres

bGrayDisabledButtons
[in] Valeur booléenne qui spécifie comment afficher les boutons non disponibles. Si ce paramètre est TRUEle cas, l’infrastructure désactive les boutons. Sinon, l’infrastructure utilise la collection d’images indisponibles par bouton.

Notes

Par défaut, les boutons indisponibles sont grisés.

`CMFCToolBar::SetHeight`

Définit la hauteur de la barre d’outils.

void SetHeight(int cyHeight);

Paramètres

cyHeight
[in] Hauteur de la barre d’outils, en pixels.

Notes

Cette méthode redessine la barre d’outils après avoir définit la hauteur.

`CMFCToolBar::SetHelpMode`

static void __stdcall SetHelpMode(BOOL bOn = TRUE);

Paramètres

[in] bOn\

Notes

`CMFCToolBar::SetHot`

BOOL SetHot(CMFCToolBarButton* pMenuButton);

Paramètres

[in] pMenuButton\

Valeur de retour

Notes

`CMFCToolBar::SetHotBorder`

Spécifie si les boutons de barre d’outils sont suivis à chaud.

void SetHotBorder(BOOL bShowHotBorder);

Paramètres

bShowHotBorder
[in] Valeur booléenne qui spécifie s’il faut effectuer le suivi à chaud des boutons de barre d’outils. Si ce paramètre est TRUEle cas, la barre d’outils effectue le suivi rapide de ses boutons. Sinon, la barre d’outils ne suit pas à chaud ses boutons.

Notes

Si un bouton est suivi à chaud, l’infrastructure met en surbrillance le bouton lorsque la souris se déplace sur celle-ci. Par défaut, chaque barre d’outils effectue le suivi rapide de ses boutons.

Appelez la CMFCToolBar::GetHotBorder méthode pour déterminer si la barre d’outils suit à chaud ses boutons.

`CMFCToolBar::SetHotTextColor`

Définit la couleur du texte pour les boutons de barre d’outils chauds.

static void SetHotTextColor(COLORREF clrText);

Paramètres

clrText
[in] Spécifie la couleur du texte pour les boutons de barre d’outils qui sont suivis à chaud.

Notes

Pour plus d’informations sur les boutons de barre d’outils suivis à chaud, consultez CMFCToolBar::GetHotBorder et CMFCToolBar::SetHotBorder.

`CMFCToolBar::SetIgnoreSetText`

void SetIgnoreSetText(BOOL bValue);

Paramètres

[in] bValue\

Notes

`CMFCToolBar::SetLargeIcons`

Spécifie si les boutons de barre d’outils affichent de grandes icônes.

static void SetLargeIcons(BOOL bLargeIcons=TRUE);

Paramètres

bLargeIcons
[in] Valeur booléenne qui spécifie les icônes à utiliser. Si ce paramètre est TRUEle cas, l’infrastructure affiche de grandes icônes. Sinon, l’infrastructure affiche des icônes régulières.

Notes

L’infrastructure appelle cette méthode lorsque l’utilisateur modifie l’état de la case à cocher Grandes icônes sous l’onglet Options de la boîte de dialogue Personnaliser . Cette méthode redimensionne toutes les barres d’outils de l’application.

Par défaut, l’infrastructure affiche des icônes régulières.

Pour plus d’informations sur la boîte de dialogue Personnaliser , consultez CMFCToolBarsCustomizeDialog Classe.

`CMFCToolBar::SetLockedSizes`

Définit les tailles des boutons verrouillés et des images verrouillées dans la barre d’outils.

void SetLockedSizes(
    SIZE sizeButton,
    SIZE sizeImage,
    BOOL bDontScale = FALSE);

Paramètres

sizeButton
[in] Spécifie la taille des boutons de barre d’outils verrouillés.

sizeImage
[in] Spécifie la taille des images de barre d’outils verrouillées.

bDontScale
Spécifie s’il faut mettre à l’échelle ou non les images de barre d’outils verrouillées en mode ppp élevé.

Notes

La taille par défaut des boutons verrouillés est de 23 x 22 pixels. La taille par défaut des images verrouillées est de 16 x 15 pixels.

Appelez la CMFCToolBar::GetLockedImageSize méthode pour récupérer la taille des images verrouillées. Appelez la CMFCToolBar::GetButtonSize méthode pour récupérer la taille des boutons de barre d’outils verrouillés.

`CMFCToolBar::SetMaskMode`

void SetMaskMode(BOOL bMasked);

Paramètres

[in] bMasked\

Notes

`CMFCToolBar::SetMenuSizes`

Définit la taille des boutons de menu de barre d’outils et leurs images.

static void __stdcall SetMenuSizes(
    SIZE sizeButton,
    SIZE sizeImage);

Paramètres

sizeButton
[in] Spécifie la taille des boutons de barre d’outils, en pixels.

sizeImage
[in] Spécifie la taille des images de barre d’outils, en pixels.

Notes

Par défaut, les boutons de menu et leurs images ont une taille non définie.

Appelez la CMFCToolBar::GetMenuButtonSize méthode pour déterminer la taille des boutons de menu et la CMFCToolBar::GetMenuImageSize méthode pour déterminer la taille des images de bouton de menu.

Consultez les exemples IEDemo et MSMoneyDemo pour obtenir des exemples qui utilisent cette méthode.

`CMFCToolBar::SetNonPermittedCommands`

Définit la liste des commandes qui ne peuvent pas être exécutées par l’utilisateur.

static void SetNonPermittedCommands(CList<UINT,UINT>& lstCommands);

Paramètres

lstCommands
[in] Référence à un CList objet qui contient les commandes qui ne peuvent pas être exécutées par l’utilisateur.

Notes

Appelez cette méthode pour empêcher l’utilisateur de sélectionner certaines commandes. Par exemple, vous pouvez empêcher l’utilisateur de sélectionner certaines commandes pour des raisons de sécurité. Consultez les exemples MDITabsDemo et MenuSubSet pour obtenir des exemples qui utilisent cette méthode.

Cette méthode efface la liste précédente des commandes non autorisées. Par défaut, la liste des commandes non autorisées est vide.

`CMFCToolBar::SetOneRowWithSibling`

Positionne la barre d’outils et son frère sur la même ligne.

void SetOneRowWithSibling();

Notes

L’infrastructure appelle cette méthode lorsque l’utilisateur sélectionne les boutons Afficher sur un bouton Ligne .

Appelez la CMFCToolBar::SetSiblingToolBar méthode pour activer les boutons Afficher sur une ligne ou afficher les boutons sur deux lignes. Si vous appelez CMFCToolBar::SetSiblingToolBar cette barre d’outils, la barre d’outils frère est déplacée vers la ligne de cette barre d’outils. Sinon, cette barre d’outils est déplacée vers la ligne du frère.

L’infrastructure appelle la CMFCToolBar::SetTwoRowsWithSibling méthode lorsque l’utilisateur sélectionne les boutons Afficher sur deux lignes .

`CMFCToolBar::SetOrigButtons`

void SetOrigButtons(const CObList& lstOrigButtons);

Paramètres

[in] lstOrigButtons\

Notes

`CMFCToolBar::SetPermament`

Spécifie si un utilisateur peut fermer la barre d’outils.

void SetPermament(BOOL bPermament=TRUE);

Paramètres

bPermament
[in] Valeur booléenne qui spécifie si un utilisateur peut fermer la barre d’outils. Si ce paramètre est TRUE, un utilisateur ne peut pas fermer la barre d’outils. Sinon, un utilisateur peut fermer la barre d’outils.

Notes

Par défaut, un utilisateur peut fermer chaque barre d’outils.

Appelez la CMFCToolBar::CanBeClosed méthode pour déterminer si un utilisateur peut fermer la barre d’outils.

`CMFCToolBar::SetRouteCommandsViaFrame`

Spécifie si le cadre parent ou le propriétaire envoie des commandes à la barre d’outils.

void SetRouteCommandsViaFrame(BOOL bValue);

Paramètres

bValue
[in] Si ce paramètre est TRUEle cas, le cadre parent envoie des commandes à la barre d’outils. Sinon, le propriétaire envoie des commandes à la barre d’outils.

Notes

Par défaut, le cadre parent envoie des commandes à la barre d’outils. Appelez la CMFCToolBar::GetRouteCommandsViaFrame méthode pour déterminer si le cadre parent ou le propriétaire envoie des commandes à la barre d’outils.

`CMFCToolBar::SetShowTooltips`

Spécifie si l’infrastructure affiche des info-bulles.

static void SetShowTooltips(BOOL bValue);

Paramètres

bValue
[in] Si ce paramètre est TRUEle cas, l’infrastructure affiche des conseils sur les outils. Sinon, l’infrastructure masque les conseils de l’outil.

Notes

Par défaut, l’infrastructure affiche des conseils sur les outils.

Appelez la méthode pour déterminer si l’infrastructure CMFCToolBar::GetShowTooltips affiche des conseils sur les outils.

`CMFCToolBar::SetSiblingToolBar`

Spécifie le frère de la barre d’outils.

void SetSiblingToolBar(CMFCToolBar* pBrotherToolbar);

Paramètres

pBrotherToolbar
[in] Pointeur vers la barre d’outils frère.

Notes

Cette méthode active les boutons Afficher sur une ligne ou afficher les boutons sur deux lignes affichés lorsque l’utilisateur affiche le menu contextuel Personnaliser . Appelez cette méthode lorsque vous souhaitez permettre à l’utilisateur de spécifier si les barres d’outils associées apparaissent sur la même ligne ou sur différentes lignes.

Appelez cette méthode après avoir activé le bouton Personnaliser qui apparaît dans la barre d’outils. Pour activer le bouton Personnaliser , appelez la CMFCToolBar::EnableCustomizeButton méthode.

Pour récupérer le frère d’une barre d’outils, appelez CMFCToolBar::GetSiblingToolBar.

`CMFCToolBar::SetSizes`

Spécifie les tailles des boutons et des images sur toutes les barres d’outils.

static void __stdcall SetSizes(
    SIZE sizeButton,
    SIZE sizeImage);

Paramètres

sizeButton
[in] Taille des boutons de barre d’outils, en pixels.

sizeImage
[in] Taille des images de bouton de barre d’outils, en pixels.

Notes

La taille par défaut des boutons de barre d’outils est de 23 x 22 pixels. La taille par défaut des images de bouton de barre d’outils est de 16 x 15 pixels.

Appelez la CMFCToolBar::GetImageSize méthode pour récupérer la taille des images de bouton de barre d’outils. Appelez la CMFCToolBar::GetButtonSize méthode pour récupérer la taille des boutons de barre d’outils.

`CMFCToolBar::SetToolBarBtnText`

Spécifie les propriétés d’un bouton dans la barre d’outils.

void SetToolBarBtnText(
    UINT nBtnIndex,
    LPCTSTR szText=NULL,
    BOOL bShowText=TRUE,
    BOOL bShowImage=TRUE);

Paramètres

nBtnIndex
[in] Index de base zéro du bouton de barre d’outils dans la liste des boutons de barre d’outils.

szText
[in] Spécifie l’étiquette de texte du bouton de barre d’outils.

bShowText
[in] Si ce paramètre est TRUEle cas, l’infrastructure affiche l’étiquette de texte. Sinon, l’infrastructure masque l’étiquette de texte.

bShowImage
[in] Si ce paramètre est TRUE, l’infrastructure affiche l’image du bouton de barre d’outils. Sinon, l’infrastructure masque l’image du bouton de barre d’outils.

Notes

Par défaut, l’infrastructure affiche les images des boutons de barre d’outils, mais n’affiche pas l’étiquette de texte des boutons de barre d’outils.

Dans les builds Debug, cette méthode génère un échec d’assertion si nBtnIndex elle ne fait pas référence à un bouton de barre d’outils valide ou si le bouton de barre d’outils est un séparateur.

`CMFCToolBar::SetTwoRowsWithSibling`

Positionne la barre d’outils et son frère sur des lignes distinctes.

void SetTwoRowsWithSibling();

Notes

L’infrastructure appelle cette méthode lorsque l’utilisateur sélectionne les boutons Afficher sur deux lignes .

Appelez la CMFCToolBar::SetSiblingToolBar méthode pour activer les boutons Afficher sur une ligne ou afficher les boutons sur deux lignes. Si vous appelez CMFCToolBar::SetSiblingToolBar cette barre d’outils, la barre d’outils frère est déplacée vers une ligne distincte. Sinon, cette barre d’outils est déplacée vers une ligne distincte.

L’infrastructure appelle la CMFCToolBar::SetOneRowWithSibling méthode lorsque l’utilisateur sélectionne les boutons Afficher sur un bouton Ligne .

`CMFCToolBar::SetUserImages`

Définit la collection d’images définies par l’utilisateur dans l’application.

static BOOL SetUserImages(CMFCToolBarImages* pUserImages);

Paramètres

pUserImages
[in] Pointeur vers la collection d’images définies par l’utilisateur.

Valeur de retour

Différent de zéro si la méthode réussit ; sinon, 0 si l’objet spécifié CMFCToolBarImages n’est pas valide ou a une taille d’image qui diffère de la taille d’image par défaut de la barre d’outils.

Notes

L’infrastructure utilise des images définies par l’utilisateur pour dessiner des boutons de barre d’outils personnalisés par l’utilisateur. La liste d’images spécifiée par pUserImages est partagée entre toutes les barres d’outils de l’application.

Cette méthode génère un échec d’assertion dans les builds Debug si l’objet spécifié CMFCToolBarImages n’est pas valide ou a une taille d’image qui diffère de la taille d’image par défaut de la barre d’outils.

Les exemples OutlookDemo, ToolTipDemo et VisualStudioDemo utilisent cette méthode pour définir la collection globale d’images définies par l’utilisateur. Ils chargent le fichier nommé UserImages.bmp, qui se trouve dans le répertoire de travail de l’application.

Appelez la méthode CMFCToolBar ::GetUserImages pour récupérer la collection d’images définies par l’utilisateur dans l’application.

`CMFCToolBar::StretchPane`

Étire la barre d’outils verticalement ou horizontalement et repositionne les boutons si nécessaire.

virtual CSize StretchPane(
    int nLength,
    BOOL bVert);

Paramètres

nLength
[in] Quantité, en pixels, par laquelle étirer le volet.

bVert
[in] Si TRUE, étire le volet verticalement. Si FALSE, étire le volet horizontalement.

Valeur de retour

Objet CSize qui spécifie la taille de la zone cliente de la barre d’outils.

Notes

Cette méthode appelle CMFCToolBar::WrapToolBar pour repositionner les boutons dans la barre d’outils étirée.

La valeur de retour est déterminée par l’appel CMFCToolBar::CalcSize.

`CMFCToolBar::TranslateChar`

Exécute une commande de bouton si le code de touche spécifié correspond à un raccourci clavier valide.

virtual BOOL TranslateChar(UINT nChar);

Paramètres

nChar
[in] Spécifie un code de clé virtuelle. Pour obtenir la liste des codes de clé virtuelle standard, consultez Winuser.h

Valeur de retour

FALSE si le code de touche spécifié n’est pas imprimable ou ne correspond pas à un raccourci clavier valide ; TRUE si le code de clé spécifié correspond à une option de menu déroulant ; sinon, la valeur de retour de CMFCToolBar::ProcessCommand.

Notes

L’infrastructure appelle cette méthode lorsqu’une touche est enfoncée avec la touche Alt .

`CMFCToolBar::UpdateButton`

Met à jour l’état du bouton spécifié.

void UpdateButton(int nIndex);

Paramètres

nIndex
[in] Spécifie l’index de base zéro du bouton à mettre à jour.

Notes

`CMFCToolBar::WrapToolBar`

Repositionne les boutons de barre d’outils dans les dimensions données.

int WrapToolBar(
    int nWidth,
    int nHeight = 32767,
    CDC* pDC = NULL,
    int nColumnWidth = -1,
    int nRowHeight = -1);

Paramètres

nWidth
[in] Largeur maximale de la barre d’outils.

nHeight
[in] Hauteur maximale de la barre d’outils. Non utilisé si la barre d’outils est flottante.

pDC
[in] Pointeur vers un contexte d’appareil. Si NULL, le contexte de l’appareil pour la barre d’outils est utilisé.

nColumnWidth
[in] Largeur du bouton. Si -1, la largeur actuelle est utilisée.

[in] m nRowHeight Hauteur du bouton. Si -1, la hauteur actuelle est utilisée.

Valeur de retour

Nombre de lignes de boutons dans la barre d’outils.

Notes

Cette méthode repositionne les boutons dans la barre d’outils, en encapsulant les boutons vers des lignes supplémentaires si nécessaire.

`CMFCToolBar::m_bDontScaleImages`

Spécifie s’il faut ou non mettre à l’échelle les images de barre d’outils en mode ppp élevé. Définissez cette option pour empêcher la mise à TRUE l’échelle de l’image lorsqu’une taille d’image ne correspond pas à une taille de bouton.

AFX_IMPORT_DATA static BOOL m_bDontScaleImages;

Voir aussi

Graphique hiérarchique
Classes
CMFCMenuBar Classe
CMFCPopupMenuBar Classe
CMFCDropDownToolBar Classe
Procédure pas à pas : placement de contrôles dans les barres d’outils

Partager via

La classe CMFCToolBar

Syntaxe

Membres

Constructeurs publics

Méthodes publiques

Méthodes protégées

Données membres

Notes

Exemple

Spécifications

Hiérarchie d'héritage

CMFCToolBar::AddBasicCommand

Paramètres

Notes

CMFCToolBar::AddCommandUsage

Paramètres

Notes

CMFCToolBar::AddToolBarForImageCollection

Paramètres

Valeur de retour

Notes

CMFCToolBar::AdjustLayout

Notes

CMFCToolBar::AdjustSize

Notes

CMFCToolBar::AllowChangeTextLabels

Valeur de retour

Notes

CMFCToolBar::AllowShowOnList

Valeur de retour

Notes

CMFCToolBar::AreTextLabels

Valeur de retour

Notes

CMFCToolBar::AutoGrayInactiveImages

Paramètres

Notes

CMFCToolBar::ButtonToIndex

Paramètres

Valeur de retour

CMFCToolBar::CalcFixedLayout

Paramètres

Valeur de retour

Notes

CMFCToolBar::CalcMaxButtonHeight

Valeur de retour

Notes

CMFCToolBar::CalcSize

Paramètres

Valeur de retour

Notes

CMFCToolBar::CanBeClosed

Valeur de retour

Notes

CMFCToolBar::CanBeRestored

Valeur de retour

Notes

CMFCToolBar::CanFocus

Valeur de retour

Notes

CMFCToolBar::CanHandleSiblings

Valeur de retour

Notes

CMFCToolBar::CleanUpImages

Notes

CMFCToolBar::CleanUpLockedImages

Notes

CMFCToolBar::CommandToIndex

Paramètres

Valeur de retour

Notes

CMFCToolBar::Create

Paramètres

Valeur de retour

Notes

CMFCToolBar::CreateEx

Paramètres

Valeur de retour

Notes

La classe `CMFCToolBar`

`CMFCToolBar::AddBasicCommand`

`CMFCToolBar::AddCommandUsage`

`CMFCToolBar::AddToolBarForImageCollection`

`CMFCToolBar::AdjustLayout`

`CMFCToolBar::AdjustSize`

`CMFCToolBar::AllowChangeTextLabels`

`CMFCToolBar::AllowShowOnList`

`CMFCToolBar::AreTextLabels`

`CMFCToolBar::AutoGrayInactiveImages`

`CMFCToolBar::ButtonToIndex`

`CMFCToolBar::CalcFixedLayout`

`CMFCToolBar::CalcMaxButtonHeight`

`CMFCToolBar::CalcSize`

`CMFCToolBar::CanBeClosed`

`CMFCToolBar::CanBeRestored`

`CMFCToolBar::CanFocus`

`CMFCToolBar::CanHandleSiblings`

`CMFCToolBar::CleanUpImages`

`CMFCToolBar::CleanUpLockedImages`

`CMFCToolBar::CommandToIndex`

`CMFCToolBar::Create`

`CMFCToolBar::CreateEx`

`CMFCToolBar::Deactivate`

`CMFCToolBar::DoPaint`

`CMFCToolBar::DrawButton`

`CMFCToolBar::DrawSeparator`

`CMFCToolBar::EnableCustomizeButton`

`CMFCToolBar::EnableDocking`

`CMFCToolBar::EnableLargeIcons`

`CMFCToolBar::EnableQuickCustomization`

`CMFCToolBar::EnableReflections`

`CMFCToolBar::EnableTextLabels`

`CMFCToolBar::FromHandlePermanent`

`CMFCToolBar::GetAllButtons`

`CMFCToolBar::GetAllToolbars`

`CMFCToolBar::GetBasicCommands`

`CMFCToolBar::GetButton`

`CMFCToolBar::GetButtonInfo`

`CMFCToolBar::GetButtonSize`

`CMFCToolBar::GetButtonStyle`

`CMFCToolBar::GetButtonText`

`CMFCToolBar::GetColdImages`

`CMFCToolBar::GetColumnWidth`

`CMFCToolBar::GetCommandButtons`

`CMFCToolBar::GetCount`