Partager via


CMFCToolBarButton, classe

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 commande Lorsque 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, CMFCToolBar, classe. Pour plus d'informations, consultez CMFCToolBarImages, classe.

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 CMFCToolBarMenuButton, classe, CMFCToolBarEditBoxButton, classe, et CMFCToolBarComboBoxButton, classe.

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);

Hiérarchie d'héritage

CObject

   CMFCToolBarButton

Configuration requise

en-tête : afxtoolbarbutton.h

Voir aussi

Référence

Graphique de la hiérarchie

CMFCToolBar, classe

CMFCToolBarImages, classe

CMFCToolBarButton::OnClick

CMFCToolBarButton::NotifyCommand

Autres ressources

classes MFC