Classe de CMFCToolBar

Article
03/12/2013

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

class CMFCToolBar : public CMFCBaseToolBar

Membres

Constructeurs publics

Nom	Description
CMFCToolBar::CMFCToolBar	Constructeur par défaut.
CMFCToolBar::~CMFCToolBar	Destructor.

Méthodes publiques

Nom	Description
CMFCToolBar::AddBasicCommand	Ajoute une commande de menu à la liste des commandes qui sont toujours affichés lorsqu'un utilisateur ouvre un menu.
CMFCToolBar::AddCommandUsage	Un index par le compteur associé à la commande donnée.
CMFCToolBar::AddToolBarForImageCollection	Ajoute des images des ressources d'interface utilisateur à la collection d'images dans l'application.
CMFCToolBar::AdjustLayout	Recalcule la taille et la position d'une barre d'outils.(Substitue 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 affichées actuellement sur les boutons de barre d'outils.
CMFCToolBar::AutoGrayInactiveImages	Activez ou les désactive la génération automatique d'images de bouton inactives.
CMFCToolBar::ButtonToIndex	Retourne l'index d'un objet spécifié de Classe de CMFCToolBarButton dans cette barre d'outils.
CMFCToolBar::CalcFixedLayout	Calcule la taille horizontale de la barre d'outils.(Substitutions CBasePane::CalcFixedLayout.)
CMFCToolBar::CalcSize	Appelé par l'infrastructure dans le cadre de le processus de calcul de disposition.(Substitutions CPane::CalcSize.)
CMFCToolBar::CanHandleSiblings	Détermine si la barre d'outils et ses frères sont positionné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 verrouillées de barre d'outils.
CMFCToolBar::CanBeClosed	Spécifie si un utilisateur peut fermer la barre d'outils.(Substitutions CBasePane::CanBeClosed.)
CMFCToolBar::CanBeRestored	Détermine si le système peut restaurer une barre d'outils à son état d'origine après personnalisation.
CMFCToolBar::CanFocus	Spécifie si le volet peut recevoir le focus.(Substitutions CBasePane::CanFocus.)
CMFCToolBar::CanHandleSiblings	Détermine si la barre d'outils et ses frères sont positionné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ée
CMFCToolBar::Create	Crée un objet CMFCToolBar.
CMFCToolBar::CreateEx	Crée un objet d' CMFCToolBar qui utilise des options de style supplémentaires, telles que de grandes icônes.
CMFCToolBar::Deactivate	Met la barre d'outils.
CMFCToolBar::EnableCustomizeButton	Active ou désactive le bouton Ajouter ou supprimer des boutons qui apparaît sur la fin de la barre d'outils.
CMFCToolBar::EnableDocking	Active l'ancrage du volet au frame principal.(Substitutions CBasePane::EnableDocking.)
CMFCToolBar::EnableLargeIcons	Active ou désactive de 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 glisser un bouton à un nouvel emplacement.
CMFCToolBar::EnableReflections	Active ou désactive la réflexion de commande.
CMFCToolBar::EnableTextLabels	Active ou désactive les étiquettes de texte sous des images de bouton de barre d'outils.
CMFCToolBar::FromHandlePermanent	Extrait un pointeur vers l'objet d' CMFCToolBar qui contient le handle de fenêtre donnée.
CMFCToolBar::GetAllButtons	Retourne une liste en lecture seule de boutons d'une barre d'outils.
CMFCToolBar::GetAllToolbars	Retourne une liste en lecture seule de toutes les barres d'outils de l'application.
CMFCToolBar::GetBasicCommands	Retourne une liste en lecture seule des commandes de base définies dans l'application.
CMFCToolBar::GetButton	Retourne un pointeur vers l'objet d' CMFCToolBarButton qui a un index spécifié de bouton de barre d'outils.
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 dans la barre d'outils.
CMFCToolBar::GetButtonStyle	Retourne le style actuellement du bouton de barre d'outils qui se trouve à l'index spécifié.
CMFCToolBar::GetButtonText	Retourne l'étiquette de texte d'un bouton possédant un index spécifié.
CMFCToolBar::GetColdImages	Retourne un pointeur vers la collection d'images froides de bouton de barre d'outils de l'application.
CMFCToolBar::GetColumnWidth	Retourne la largeur des boutons de barre d'outils.
CMFCToolBar::GetCommandButtons	Retourne une liste des boutons ayant un ID de commande spécifié 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	Extrait un pointeur vers l'objet d' CMFCCustomizeButton associé à la barre d'outils.
CMFCToolBar::GetDefaultImage	Retourne l'index de l'image par défaut pour un bouton de barre d'outils avec un ID de commande spécifiée
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	Extrait un pointeur vers l'objet de bouton de menu qui affiche actuellement le sous-menu.
CMFCToolBar::GetGrayDisabledButtons	Spécifie si les images des boutons désactivés sont des versions estompées des images de bouton normales, ou pris 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 chaud-sont suivis.
CMFCToolBar::GetHotTextColor	Retourne la couleur du texte des boutons de barre d'outils en surbrillance.
CMFCToolBar::GetHwndLastFocus	Retourne un handle vers la fenêtre qui avait le focus d'entrée juste avant la barre d'outils ait fini.
CMFCToolBar::GetIgnoreSetText	Spécifie si les appels définir les é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 l'index décalé utilisé pour rechercher les images de bouton de barre d'outils pour cette barre d'outils de la liste globale d'images de bouton de barre d'outils.
CMFCToolBar::GetInvalidateItemRect	Extrait la zone 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 de grandes froides images de bouton de barre d'outils de l'application.
CMFCToolBar::GetLargeDisabledImages	Retourne un pointeur vers la collection de grandes désactivées images de bouton de barre d'outils de l'application.
CMFCToolBar::GetLargeImages	Retourne un pointeur vers la collection de grandes images de bouton de barre d'outils de 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 verrouillées de barre d'outils.
CMFCToolBar::GetLockedMenuImages	Retourne un pointeur vers la collection d'images verrouillées de menu de la barre d'outils 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	Extrait la collection de boutons non personnalisés de la barre d'outils.
CMFCToolBar::GetOrigResetButtons	Extrait la collection de boutons de redémarrage non personnalisés de la barre d'outils.
CMFCToolBar::GetResourceID	Extrait l'ID de ressource de la barre d'outils.
CMFCToolBar::GetRouteCommandsViaFrame	Détermine qu'objet, le frame parent ou le propriétaire, envoie des commandes de la barre d'outils.
CMFCToolBar::GetRowHeight	Retourne la hauteur de boutons de barre d'outils.
CMFCToolBar::GetShowTooltips	Spécifie si les info-bulles s'affichent 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 définies par l'utilisateur de bouton de barre d'outils de 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 du menu Personnaliser .
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 (non accentuées inactives) est activée.
CMFCToolBar::IsBasicCommand	Détermine si une commande est dans la liste de commandes de base.
CMFCToolBar::IsButtonExtraSizeAvailable	Détermine si la barre d'outils peut afficher des boutons qui ont étendu des bordures.
CMFCToolBar::IsButtonHighlighted	Détermine si un bouton dans 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 (consultez 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 dans l'application affichent en cours de grandes icônes.
CMFCToolBar::IsLastCommandFromButton	Détermine si la commande récemment exécutée a été envoyée 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 la barre d'outils sœurs 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 des images de barre d'outils des ressources d'application.
CMFCToolBar::LoadBitmapEx	Charge des images de barre d'outils des ressources d'application.Inclut de grandes images.
CMFCToolBar::LoadParameters	Charge des options globales de barre d'outils dans le Registre Windows.
CMFCToolBar::LoadState	Charge les informations d'état de la barre d'outils dans le Registre Windows.(Substitutions CPane::LoadState.)
CMFCToolBar::LoadToolBar	Charge la barre d'outils des ressources d'application.
CMFCToolBar::LoadToolBarEx	Charge la barre d'outils des ressources d'application à l'aide de la classe d'assistance d' CMFCToolBarInfo pour permettre à l'application d'utiliser de grandes images.
CMFCToolBar::OnChangeHot	Appelé par l'infrastructure lorsqu'un utilisateur sélectionne un bouton dans la barre d'outils.
CMFCToolBar::OnFillBackground	Appelé par l'infrastructure de CBasePane::DoPaint pour remplir arrière-plan de barre d'outils.
CMFCToolBar::OnReset	Restaure la barre d'outils à son état d'origine.
CMFCToolBar::OnSetAccData	(Substitutions 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 de l'index spécifié de la barre d'outils.
CMFCToolBar::RemoveStateFromRegistry	Supprime les informations d'état de la barre d'outils dans le Registre Windows.
CMFCToolBar::ReplaceButton	Remplace un bouton de barre d'outils avec un autre bouton de barre d'outils.
CMFCToolBar::ResetAll	Restaure les barres d'outils à leur état d'origine.
CMFCToolBar::ResetAllImages	Efface toutes les collections d'image de barre d'outils de l'application.
CMFCToolBar::RestoreOriginalstate	Restaure l'état d'origine d'une barre d'outils.
CMFCToolBar::SaveState	Enregistre les informations d'état de la barre d'outils dans le Registre Windows.(Substitutions CPane::SaveState.)
CMFCToolBar::Serialize	(Substitutions CBasePane::Serialize.)
CMFCToolBar::SetBasicCommands	Définit la liste des commandes qui sont toujours affichés 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 si 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 dans 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 chaud- sont suivis.
CMFCToolBar::SetHotTextColor	Définit la couleur de texte pour les boutons de barre d'outils chauds.
CMFCToolBar::SetLargeIcons	Spécifie si les boutons de barre d'outils afficher 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 la barre d'outils et de leurs images.
CMFCToolBar::SetNonPermittedCommands	Définit la liste des commandes qui ne peut pas être exécutée par l'utilisateur.
CMFCToolBar::SetOneRowWithSibling	Positionne la barre d'outils et ses frères sur la même ligne les.
CMFCToolBar::SetPermament	Spécifie si un utilisateur peut fermer la barre d'outils.
CMFCToolBar::SetRouteCommandsViaFrame	Spécifie si le frame parent ou le propriétaire envoie des commandes de 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 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 ses frères sur les 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. (Substitutions CBasePane::StretchPane.)
CMFCToolBar::TranslateChar	Exécute une commande de bouton si le code de touche spécifié correspond à un raccourci clavier valide.
CMFCToolBar::UpdateButton	Met à jour l'état du bouton spécifié.
CMFCToolBar::WrapToolBar	Repositionne des 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 s'affiche 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	Redessine une barre d'outils.
CMFCToolBar::DrawButton	Redessine un bouton de barre d'outils.
CMFCToolBar::DrawSeparator	Redessine un séparateur d'une barre d'outils.
CMFCToolBar::OnUserToolTip	Appelé par l'infrastructure lorsque l'info-bulle pour un bouton est sur le point d'être affiché.

Membres de données

Nom	Description
CMFCToolBar::m_bDontScaleImages	Spécifie que, mettre à l'échelle ou non des images de barre d'outils en mode élevé PPP.
CMFCToolBar::m_dblLargeImageRatio	Spécifie le taux de la dimension (hauteur ou largeur) de grandes icônes de la dimension des images normales.

Notes

Pour lier un objet d' CMFCToolBar à votre application, suivez ces étapes :

Ajoutez un objet d' CMFCToolBar à la fenêtre frame principale.
Lorsque vous utilisez le message d' WM_CREATE de la fenêtre frame principale, appelez CMFCToolBar::Create ou CMFCToolBar::CreateEx pour créer la barre d'outils et pour spécifier son style.
Appelez CBasePane::EnableDocking pour spécifier le style d'ancrage.

Pour insérer un bouton particulier, tel qu'une zone de liste déroulante ou une barre d'outils de liste déroulante, réservent un bouton factice dans la ressource parent, et remplacent le bouton factice au moment de l'exécution à l'aide de CMFCToolBar::ReplaceButton.Pour plus d'informations, consultez Procédure pas - à - pas : Disposition des contrôles sur les barres d'outils.

CMFCToolBar est la classe de base pour les classes de la bibliothèque MFC Classe de CMFCMenuBar, Classe de CMFCPopupMenuBar, et Classe de CMFCDropDownToolBar.

Exemple

L'exemple suivant montre comment utiliser différentes méthodes dans la classe d' CMFCToolBar .L'exemple suivant indique comment définir le texte de l'étiquette de la fenêtre de la barre d'outils, définir les zones, définir le style du volet, et activer le bouton Ajouter ou supprimer des boutons qui apparaît sur la fin de la barre d'outils.Cet extrait de code fait partie d' Exemple de démonstration d'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..."));