La classe CMFCToolBar

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	Mises à 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 :

1. Ajoutez un CMFCToolBar objet à la fenêtre de cadre principale.

2. Lorsque vous traitez le message WM_CREATE pour la fenêtre cadre principale, appelez ou CMFCToolBar::CreateCMFCToolBar::CreateEx créez la barre d’outils et spécifiez son style.

3. 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êteafxtoolbar.h:

Hiérarchie d'héritage

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

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 étiquette de texte Afficher les étiquettes de texte case activée-box 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_HORZTRUE

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éeTRUE, 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 zone case activée 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 ToSTYLE_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 : Message Réflexions ion 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 étiquette de texte Afficher case activée-box dans la page Barres d’outils. Lorsque l’utilisateur sélectionne une barre d’outils et case activée cette option, l’infrastructure appelle EnableTextLabels la barre d’outils sélectionnée. Vous pouvez désactiver la zone de case activée d’un objet dérivé de CMFCToolBarFALSECMFCToolBar::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;

Paramètres

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

rString
[out] Texte de l’étiquette du bouton de barre d’outils.

Valeur de retour

Texte de l’étiquette du bouton de barre d’outils.

Notes

Appelez ou CMFCToolBar::SetToolBarBtnText définissez CMFCToolBar::SetButtonText l’étiquette de texte.

CMFCToolBar::GetColdImages

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

static CMFCToolBarImages* GetColdImages();

Valeur de retour

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

Notes

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

CMFCToolBar::GetColumnWidth

Retourne la largeur des boutons de barre d’outils.

virtual int GetColumnWidth() const;

Valeur de retour

Valeur qui spécifie la largeur des boutons de barre d’outils.

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 largeur de colonne différente pour votre 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.

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

uiID
[in] Spécifie l’ID de commande du bouton.

Valeur de retour

Index de l’image de barre d’outils dans la liste partagée d’images.

Notes

Utilisez cette méthode partagée pour récupérer l’index de l’image par défaut d’un bouton de barre d’outils avec l’ID de commande spécifié. La valeur de retour est un index dans la collection partagée d’images de bouton de barre d’outils pour toutes les barres d’outils de l’application. Appelez la CMFCToolBar::GetImages méthode pour obtenir un pointeur vers cette collection.

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.

static CMFCToolBarImages* __stdcall GetDisabledImages();

Valeur de retour

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

Notes

Chargez les images de bouton de barre d’outils désactivées à l’aide de la CMFCToolBarEditBoxButton classe et CMFCToolBar::LoadBitmap des méthodes.

CMFCToolBar::GetDisabledMenuImages

Retourne un pointeur vers la collection d’images utilisées pour les boutons de menu désactivés dans l’application.

static CMFCToolBarImages* __stdcall GetDisabledMenuImages();

Valeur de retour

Pointeur vers la collection d’images de menu désactivées.

Notes

Chargez les images désactivées à l’aide de la CMFCToolBarEditBoxButton méthode Class .

CMFCToolBar::GetDroppedDownMenu

Récupère un pointeur vers l’objet bouton de menu qui affiche actuellement son sous-menu.

CMFCToolBarMenuButton* GetDroppedDownMenu(int* pIndex = NULL) const;

Paramètres

pIndex
[out] Reçoit l’index du bouton dans la collection de boutons de barre d’outils.

Valeur de retour

Pointeur vers l’objet bouton de menu qui affiche son sous-menu ou NULL si aucun menu n’affiche son sous-menu.

Notes

Si cette méthode retourne une valeur non null et pIndex n’est pas NULL, la valeur pointée par pIndex est définie sur l’index du bouton de menu dans la collection de boutons de barre d’outils.

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.

BOOL GetGrayDisabledButtons() const;

Valeur de retour

TRUE pour désactiver les images des boutons désactivés ; FALSE pour obtenir des images de la collection d’images désactivées.

Notes

Permet CMFCToolBar::SetGrayDisabledButtons de basculer entre les images grisées et les images de la collection d’images désactivées.

CMFCToolBar::GetHighlightedButton

Retourne un pointeur vers le bouton de barre d’outils actuellement mis en surbrillance.

CMFCToolBarButton* GetHighlightedButton() const;

Valeur de retour

Pointeur vers un objet bouton de barre d’outils ; ou NULL si aucun bouton n’est mis en surbrillance.

Notes

Un bouton de barre d’outils est mis en surbrillance s’il a le focus clavier. Un bouton de barre d’outils est également mis en surbrillance si les boutons de barre d’outils sont suivis à chaud dans cette application (pour plus d’informations, voir CMFCToolBar::GetHotBorder et CMFCToolBar::SetHotBorder) et que la souris pointe dessus lorsqu’aucun bouton de barre d’outils ou élément de menu n’a le focus clavier.

CMFCToolBar::GetHotBorder

Détermine si les boutons de barre d’outils sont suivis à chaud. Si un bouton est suivi à chaud, il est mis en surbrillance lorsque la souris se déplace dessus.

BOOL GetHotBorder() const;

Valeur de retour

TRUE si les boutons de barre d’outils sont suivis à chaud ; sinon, FALSE.

Notes

Par défaut, 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.

static COLORREF GetHotTextColor();

Valeur de retour

Valeur COLORREF qui représente la couleur de texte en surbrillance actuelle.

Notes

Appel CMFCToolBar::SetHotTextColor pour définir une nouvelle couleur de texte pour les 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.

HWND GetHwndLastFocus() const;

Valeur de retour

Handle vers la fenêtre qui n’est pas dérivée de CMFCBaseToolBar la classe, qui avait précédemment le focus d’entrée ; ou NULL s’il n’y a pas de fenêtre de ce type.

Notes

Lorsqu’un CMFCToolBar contrôle reçoit le focus d’entrée, il stocke un handle dans la fenêtre qui a perdu le focus afin qu’il puisse le restaurer ultérieurement.

CMFCToolBar::GetIgnoreSetText

Spécifie si les appels à définir des étiquettes de bouton sont ignorés.

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.

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 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.

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.

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.

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 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 à case activée.

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 à case activée.

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 à case activée.

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 les icônes volumineuses case activée-box 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 zone Grandes icônes case activée dans 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

Mises à 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] mnRowHeight 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