Classe de CMFCToolBarButton

Article
03/04/2013

Fournit les fonctionnalités de bouton à des barres d'outils.

class CMFCToolBarButton : public CObject

Membres

Constructeurs publics

Nom	Description
CMFCToolBarButton::CMFCToolBarButton	Les éléments et initialise un objet d' CMFCToolBarButton .
CMFCToolBarButton::~CMFCToolBarButton	Destructor.

Méthodes publiques

Nom	Description
CMFCToolBarButton::CanBeDropped	Spécifie si un utilisateur peut positionner un bouton dans une barre d'outils ou le menu pendant la personnalisation.
CMFCToolBarButton::CanBeStored	Spécifie si le bouton peut être stocké.
CMFCToolBarButton::CanBeStretched	Spécifie si un utilisateur peut étirer le bouton pendant la personnalisation.
CMFCToolBarButton::CompareWith	Compare cette instance à l'objet fourni d' CMFCToolBarButton .
CMFCToolBarButton::CopyFrom	Copie les propriétés d'un autre bouton de barre d'outils sur le bouton actuel.
CMFCToolBarButton::CreateFromOleData	Crée un objet d' CMFCToolBarButton de l'objet fourni d' COleDataObject .
CMFCToolBarButton::CreateObject	Utilisé par l'infrastructure pour créer une instance dynamique de ce type de classe.
CMFCToolBarButton::EnableWindow	Active ou désactive l'entrée de souris et de clavier.
CMFCToolBarButton::ExportToMenuButton	Les copies du texte du bouton de barre d'outils à un menu.
CMFCToolBarButton::GetClipboardFormat	Récupère le format de presse-papiers global pour l'application.
CMFCToolBarButton::GetHwnd	Récupère le handle de fenêtre associée au bouton de barre d'outils.
CMFCToolBarButton::GetImage	Récupère l'index d'image du bouton.
CMFCToolBarButton::GetInvalidateRect	Extrait la zone de la zone cliente du bouton qui doit être redessiné.
CMFCToolBarButton::GetParentWnd	Extrait la fenêtre parente du bouton.
CMFCToolBarButton::GetProtectedCommands	Récupère la liste des commandes que l'utilisateur ne peut pas personnaliser.
CMFCToolBarButton::GetTextSize	Extrait la taille du texte du bouton.
CMFCToolBarButton::HasFocus	Détermine si le bouton a le focus d'entrée actuel.
CMFCToolBarButton::HaveHotBorder	Détermine si une bordure du bouton s'affiche lorsqu'un utilisateur sélectionne le bouton.
CMFCToolBarButton::IsDrawImage	Détermine si une image est affichée sur le bouton.
CMFCToolBarButton::IsDrawText	Détermine si une étiquette de texte s'affiche sur le bouton.
CMFCToolBarButton::IsDroppedDown	Détermine si le bouton affiche un sous-menu.
CMFCToolBarButton::IsEditable	Détermine si le bouton peut être personnalisé.
CMFCToolBarButton::IsExtraSize	Détermine si le bouton peut être affiché avec une bordure étendue.
CMFCToolBarButton::IsFirstInGroup	Détermine si le bouton est dans la première position à son groupe de boutons.
CMFCToolBarButton::IsHidden	Détermine si le bouton est masqué.
CMFCToolBarButton::IsHorizontal	Détermine si le bouton se trouve sur une barre d'outils horizontale.
CMFCToolBarButton::IsLastInGroup	Spécifie si le bouton est en dernière position à son groupe de boutons.
CMFCToolBarButton::IsLocked	Détermine si le bouton est d'une barre d'outils (non personnalisable) verrouillée.
CMFCToolBarButton::IsOwnerOf	Détermine si le bouton est le propriétaire de le handle de fenêtre fournie.
CMFCToolBarButton::IsVisible	Détermine si le bouton de barre d'outils est visible.
CMFCToolBarButton::IsWindowVisible	Détermine si le handle de fenêtre sous-jacente du bouton est visible.
CMFCToolBarButton::NotifyCommand	Spécifie si le bouton traite le message de WM_COMMAND .
CMFCToolBarButton::OnAddToCustomizePage	Appelé par l'infrastructure lorsque le bouton est ajouté à une boîte de dialogue Personnaliser .
CMFCToolBarButton::OnBeforeDrag	Spécifie si le bouton peut être déplacé.
CMFCToolBarButton::OnBeforeDrop	Spécifie si un utilisateur peut supprimer le bouton sur la barre d'outils cible.
CMFCToolBarButton::OnCalculateSize	Appelé par l'infrastructure pour calculer la taille du bouton pour le contexte de périphérique et l'état spécifié d'ancrage.
CMFCToolBarButton::OnCancelMode	Appelé par l'infrastructure pour gérer le message de WM_CANCELMODE .
CMFCToolBarButton::OnChangeParentWnd	Appelé par l'infrastructure lorsque le bouton est inséré dans une nouvelle barre d'outils.
CMFCToolBarButton::OnClick	Appelé par l'infrastructure lorsque l'utilisateur clique sur le bouton de la souris.
CMFCToolBarButton::OnClickUp	Appelé par l'infrastructure lorsque l'utilisateur relâche le bouton de la souris.
CMFCToolBarButton::OnContextHelp	Appelé par l'infrastructure lorsque la barre d'outils parent gère un message d' WM_HELPHITTEST .
CMFCToolBarButton::OnCtlColor	Appelé par l'infrastructure lorsque la barre d'outils parent gère un message d' WM_CTLCOLOR .
CMFCToolBarButton::OnCustomizeMenu	Permet au bouton pour modifier le menu fourni lorsque l'application affiche un menu contextuel dans la barre d'outils parente.
CMFCToolBarButton::OnDblClk	Appelé par l'infrastructure lorsque la barre d'outils parent gère un message de WM_LBUTTONDBLCLK .
CMFCToolBarButton::OnDraw	Appelé par l'infrastructure pour dessiner le bouton en utilisant des styles et des options spécifiés.
CMFCToolBarButton::OnDrawOnCustomizeList	Appelé par l'infrastructure pour dessiner le bouton dans le volet Commandes de la boîte de dialogue Personnaliser .
CMFCToolBarButton::OnGetCustomToolTipText	Appelé par l'infrastructure pour récupérer le texte personnalisé d'info-bulle pour le bouton.
CMFCToolBarButton::OnGlobalFontsChanged	Appelé par l'infrastructure lorsque la police globale a changé.
CMFCToolBarButton::OnMove	Appelé par l'infrastructure lorsque la barre d'outils parent passe.
CMFCToolBarButton::OnShow	Appelé par l'infrastructure lorsque le bouton devient visible ou invisible.
CMFCToolBarButton::OnSize	Appelé par l'infrastructure lorsque la barre d'outils parent modifie sa taille ou position et cette modification implique de le bouton de modifier la taille.
CMFCToolBarButton::OnToolHitTest	Appelé par l'infrastructure lorsque la barre d'outils parent doit déterminer si un point se trouve dans le rectangle englobant du bouton.
CMFCToolBarButton::OnUpdateToolTip	Appelé par l'infrastructure lorsque la barre d'outils parent gère son texte d'info-bulle.
CMFCToolBarButton::PrepareDrag	Appelé par l'infrastructure lorsque le bouton est sur le point d'exécuter une opération de glisser-déplacer.
CMFCToolBarButton::Rect	Récupère le rectangle englobant du bouton.
CMFCToolBarButton::ResetImageToDefault	Définit la valeur par défaut l'image associée au bouton.
CMFCToolBarButton::SaveBarState	Enregistre l'état du bouton de barre d'outils.
CMFCToolBarButton::Serialize	Lit cet objet d'une archive ou l'écrit dans une archive.(Substitutions CObject::Serialize.)
CMFCToolBarButton::SetACCData	Remplit l'objet fourni d' CAccessibilityData avec les données d'accessibilité du bouton de barre d'outils.
CMFCToolBarButton::SetClipboardFormatName	Renomme le format de presse-papiers global.
CMFCToolBarButton::SetImage	Définit l'index d'image du bouton.
CMFCToolBarButton::SetProtectedCommands	Définit la liste des commandes que l'utilisateur ne peut pas personnaliser.
CMFCToolBarButton::SetRadio	Appelé par l'infrastructure lorsqu'un bouton modifie son état activé.
CMFCToolBarButton::SetRect	Définit le rectangle englobant du bouton.
CMFCToolBarButton::SetStyle	Définit le style du bouton.
CMFCToolBarButton::SetVisible	Spécifie si le bouton est visible.
CMFCToolBarButton::Show	Affiche ou masque le bouton.

Membres de données

Nom	Description
CMFCToolBarButton::m_bImage	Spécifie si une image est affichée sur le bouton.
CMFCToolBarButton::m_bText	Spécifie si une étiquette de texte s'affiche sur le bouton.
CMFCToolBarButton::m_bTextBelow	Spécifie si l'étiquette de texte s'affiche sous l'image sur le bouton.
CMFCToolBarButton::m_bUserButton	Spécifie si le bouton a une image définie par l'utilisateur.
CMFCToolBarButton::m_bWholeText	Spécifie si le bouton affiche l'étiquette de texte intégral même s'il ne tient pas dans le rectangle englobant.
CMFCToolBarButton::m_bWrap	Spécifie si le bouton en regard d'un séparateur est mis sur la ligne suivante.
CMFCToolBarButton::m_bWrapText	Spécifie si les étiquettes de texte multilignes sont activées.
CMFCToolBarButton::m_nID	l'ID de commande du bouton.
CMFCToolBarButton::m_nStyle	Le style du bouton.
CMFCToolBarButton::m_strText	l'étiquette de texte du bouton.

Notes

Un objet d' CMFCToolbarButton est un contrôle qui réside sur une barre d'outils.Son comportement ressemble à celui d'un bouton simple.Vous pouvez assigner une image et une étiquette de texte à cet objet.Un bouton de barre d'outils peut également avoir un ID de commandeLorsque l'utilisateur clique sur le bouton de barre d'outils, l'infrastructure exécute la commande que cet ID spécifie.

En général, les boutons de barre d'outils peuvent être personnalisés : l'utilisateur peut faire glisser des boutons d'une barre d'outils vers un autre, et copier, coller, supprimer, et modifier des étiquettes de texte et des images.Pour empêcher l'utilisateur de personnaliser la barre d'outils, vous pouvez verrouiller la barre d'outils de deux façons.L'un ou l'autre a défini la balise d' bLocked à TRUE lorsque vous appelez CMFCToolBar::LoadToolBar, ou ajoute l'ID de commande d'un bouton individuel à la liste globale de commandes protégées à l'aide de la méthode de CMFCToolBarButton::SetProtectedCommands .

CMFCToolBarButton objets afficher des images des collections globales d'images de barre d'outils de l'application.Ces collections sont mises à jour dans la barre d'outils parente, Classe de CMFCToolBar.Pour plus d'informations, consultez Classe de CMFCToolBarImages.

Lorsque l'utilisateur clique sur un bouton de barre d'outils, sa barre d'outils parente traite le message de la souris et communique les actions appropriées au bouton.Si le bouton a un ID de commande valide, la barre d'outils parent envoie le message d' WM_COMMAND au frame parent.

La classe d' CMFCToolBarButton est la classe de base pour d'autres classes de bouton de barre d'outils, telles que Classe de CMFCToolBarMenuButton, Classe de CMFCToolBarEditBoxButton, et Classe de CMFCToolBarComboBoxButton.

Exemple

L'exemple suivant montre comment configurer un objet d' CMFCToolBarButton en utilisant différentes méthodes dans la classe d' CMFCToolBarButton .L'exemple montre comment activer le clavier et de souris d'entrer, de définir l'index d'image du bouton, de définir le rectangle englobant du bouton, et de rendre le bouton visible.Cet extrait de code fait partie d' Exemple de contrôle tab.

    CMFCToolBarButton* pOffice2007 = NULL;
    int nIndex = -1;
    
    for (UINT uiCmd = ID_VIEW_APPLOOK_2007_1; uiCmd <= ID_VIEW_APPLOOK_2007_4; uiCmd++)
    {
        // CMFCToolBar  m_wndToolBarTheme
        nIndex = m_wndToolBarTheme.CommandToIndex (uiCmd);

        CMFCToolBarButton* pButton = m_wndToolBarTheme.GetButton (nIndex);
    
        if (pButton != NULL)
        {
            pOffice2007 = pButton;
            break;
        }
    }


...


    pOffice2007->EnableWindow();
    pOffice2007->SetImage(1);
    pOffice2007->SetRect( CRect(1,1,1,1));
    pOffice2007->SetVisible();
    pOffice2007->Show(true);