Classe de CMFCDropDownToolBar

Article
03/04/2013

Une barre d'outils qui s'affiche lorsque l'utilisateur appuie sur et contient un bouton de barre d'outils de niveau supérieur.

class CMFCDropDownToolBar : public CMFCToolBar

Membres

Méthodes publiques

Nom	Description
CMFCDropDownToolBar::AllowShowOnPaneMenu	(Substitutions CPane::AllowShowOnPaneMenu.)
CMFCDropDownToolBar::LoadBitmap	(Substitutions CMFCToolBar::LoadBitmap.)
CMFCDropDownToolBar::LoadToolBar	(Substitutions CMFCToolBar::LoadToolBar.)
CMFCDropDownToolBar::OnLButtonUp
CMFCDropDownToolBar::OnMouseMove
CMFCDropDownToolBar::OnSendCommand	(Substitutions CMFCToolBar::OnSendCommand.)
CMFCDropDownToolBar::OnUpdateCmdUI	(Substitutions CMFCToolBar : : OnUpdateCmdUI.)

Remarques

Un objet d' CMFCDropDownToolBar combine l'apparence visuelle d'une barre d'outils avec le comportement d'un menu contextuel.Lorsqu'un utilisateur appuie et de contient un bouton de barre d'outils déroulant (consultez Classe de CMFCDropDownToolbarButton), une barre d'outils déroulante s'affiche, et l'utilisateur peut sélectionner un bouton de la barre d'outils déroulante en faisant défiler à celui-ci et en libérant le bouton de la souris.Une fois que l'utilisateur sélectionne un bouton dans la barre d'outils déroulante, ce bouton est affiché comme bouton actuellement dans la barre d'outils de niveau supérieur.

Une barre d'outils déroulante ne peut pas être personnalisée ou ancrée, et il n'a pas d'état d'arrachement.

l'illustration suivante montre un objet d' CMFCDropDownToolBar :

Capture d'écran CMFCDropDownToolbar

Vous créez un objet d' CMFCDropDownToolBar la même façon que vous créez une barre d'outils ordinaire (consultez Classe de CMFCToolBar).

Pour insérer la barre d'outils déroulante dans la barre d'outils parente :

1.Réservez un ID de ressource factice pour le bouton dans la ressource parente de barre d'outils.

2.Créez un objet d' CMFCDropDownToolBarButton qui contient la barre d'outils déroulante (pour plus d'informations, consultez CMFCDropDownToolbarButton::CMFCDropDownToolbarButton).

3.Remplacez le bouton factice avec l'objet d' CMFCDropDownToolBarButton à l'aide de CMFCToolBar::ReplaceButton.

Pour plus d'informations sur les boutons de barre d'outils, consultez Procédure pas - à - pas : Disposition des contrôles sur les barres d'outils.Pour obtenir un exemple d'une barre d'outils déroulante, consultez l'exemple VisualStudioDemo de projet.

Exemple

L'exemple suivant montre comment utiliser la méthode d' Create dans la classe d' CMFCDropDownToolBar .Cet extrait de code fait partie d' Exemple de démonstration de Visual Studio.

    CMFCDropDownToolBar m_wndToolbarResource;


...


    // Create Resource toolbar:
    // The this pointer points to CMainFrame class which extends the CMDIFrameWndEx class
    if (!m_wndToolbarResource.Create(this, WS_CHILD|CBRS_TOP|CBRS_TOOLTIPS|CBRS_FLYBY|CBRS_HIDE_INPLACE|CBRS_SIZE_DYNAMIC| CBRS_GRIPPER | CBRS_BORDER_3D, IDR_TOOLBAR_RESOURCE) || !m_wndToolbarResource.LoadToolBar(IDR_TOOLBAR_RESOURCE))
    {
        TRACE0("Failed to create build toolbar\n");
        return FALSE;      // fail to create
    }