Partager via

CMFCDropDownToolBar, classe

  • Article

Barre d'outils qui s'affiche lorsque l'utilisateur appuie sur un bouton de barre d'outils de niveau supérieur et le maintient enfoncé.

Pour plus d’informations, consultez le code source situé dans le dossier VC\atlmfc\src\mfc de votre installation de Visual Studio.

Syntaxe

class CMFCDropDownToolBar : public CMFCToolBar

Membres

Méthodes publiques

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

Notes

Un CMFCDropDownToolBar objet combine l’apparence visuelle d’une barre d’outils avec le comportement d’un menu contextuel. Lorsqu’un utilisateur appuie sur un bouton de barre d’outils déroulant (voir CMFCDropDownToolbarButton, classe), une barre d’outils déroulante s’affiche et l’utilisateur peut sélectionner un bouton dans la barre d’outils déroulante en le faisant défiler et en la libérant. Une fois que l’utilisateur a sélectionné un bouton dans la barre d’outils déroulante, ce bouton s’affiche en tant que bouton actif 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 elle n’a pas d’état de déchirure.

L’illustration suivante montre un CMFCDropDownToolBar objet :

Exemple de CMFCDropDownToolbar.

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

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

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

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

  3. Remplacez le bouton factice par l’objet à l’aide CMFCDropDownToolBarButton de CMFCToolBar ::ReplaceButton.

Pour plus d’informations sur les boutons de barre d’outils, consultez Procédure pas à pas : Mise en place de contrôles dans les barres d’outils. Pour obtenir un exemple de barre d’outils déroulante, consultez l’exemple de projet VisualStudioDemo.

Exemple

L’exemple suivant montre comment utiliser la Create méthode dans la CMFCDropDownToolBar classe. Cet extrait de code fait partie de l’exemple de démonstration 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
}

Hiérarchie d'héritage

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

CMFCToolBar

CMFCDropDownToolBar

Spécifications

En-tête : afxdropdowntoolbar.h

CMFCDropDownToolBar ::AllowShowOnPaneMenu

virtual BOOL AllowShowOnPaneMenu() const;

Valeur de retour

Notes

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

bloqué
[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 méthode CMFCToolBar::LoadToolBarEx appelle cette méthode pour charger les images qui sont 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.

CMFCDropDownToolBar ::LoadToolBar

virtual BOOL LoadToolBar(
    UINT uiResID,
    UINT uiColdResID = 0,
    UINT uiMenuResID = 0,
    BOOL = FALSE,
    UINT uiDisabledResID = 0,
    UINT uiMenuDisabledResID = 0,
    UINT uiHotResID = 0);

Paramètres

[in] uiResID

[in] uiColdResID

[in] uiMenuResID

[in] BOOL

[in] uiDisabledResID

[in] uiMenuDisabledResID

[in] uiHotResID

Valeur de retour

Notes

CMFCDropDownToolBar ::OnLButtonUp

afx_msg void OnLButtonUp(
    UINT nFlags,
    CPoint point);

Paramètres

[in] nFlags

[in] point

Notes

CMFCDropDownToolBar ::OnMouseMove

afx_msg void OnMouseMove(
    UINT nFlags,
    CPoint point);

Paramètres

[in] nFlags

[in] point

Notes

CMFCDropDownToolBar ::OnSendCommand

virtual BOOL OnSendCommand(const CMFCToolBarButton* pButton);

Paramètres

[in] pButton

Valeur de retour

Notes

CMFCDropDownToolBar ::OnUpdateCmdUI

virtual void OnUpdateCmdUI(
    CFrameWnd* pTarget,
    BOOL bDisableIfNoHndler);

Paramètres

[in] pTarget

[in] bDisableIfNoHndler

Notes

Voir aussi

Graphique hiérarchique
Classes
CMFCToolBar, classe
CMFCToolBar ::Create
CMFCToolBar ::ReplaceButton
CMFCDropDownToolbarButton, classe
Procédure pas à pas : placement de contrôles dans les barres d’outils