Partager via


CMFCToolBarMenuButton::CMFCToolBarMenuButton

Construit un objet CMFCToolBarMenuButton.

CMFCToolBarMenuButton();
CMFCToolBarMenuButton(
   const CMFCToolBarMenuButton& src 
);
CMFCToolBarMenuButton(
   UINT uiID,
   HMENU hMenu,
   int iImage,
   LPCTSTR lpszText=NULL,
   BOOL bUserButton=FALSE 
);

Paramètres

  • [in] src
    Un objet existant d' CMFCToolBarMenuButton à copier dans cet objet d' CMFCToolBarMenuButton .

  • [in] uiID
    L'ID de la commande à exécuter lorsqu'un utilisateur clique sur le bouton ; ou (UINT) - 1 pour un bouton de menu qui n'est pas directement une commande.

  • [in] hMenu
    Un handle d'un menu ; ou NULL si le bouton ne possède pas de menu.

  • [in] iImage
    Index de l'image pour le bouton ; ou -1 si ce bouton n'a pas d'icône ou n'utilise pas l'icône associée à la commande spécifiée par uiID. L'index est le même pour chaque objet d' CMFCToolBarImages dans votre application.

  • [in] lpszText
    Le texte du bouton de menu de la barre d'outils.

  • [in] bUserButton
    TRUE si le bouton affiche une image définie par l'utilisateur ; FALSE si le bouton affiche une image prédéfinie associée à la commande spécifiée par uiID.

Notes

Si uiID est un ID de commande valide, le bouton exécute cette commande lorsque l'utilisateur clique dessus. Si hMenu est un handle valide de menu, le bouton fournit un menu déroulant lorsqu'il apparaît dans une barre d'outils ou un sous-menu lorsqu'il apparaît dans un menu. Si uiID et hMenu sont valides, le bouton est un bouton partagé avec une partie qui exécutera la commande lorsque l'utilisateur clique sur ce dernier et une partie avec une flèche bas qui déroulant un menu lorsque l'utilisateur clique sur. Toutefois, si hMenu est valide, un utilisateur ne pourra pas cliquer sur le bouton pour exécuter une commande lorsque le bouton est inséré dans un menu.

Exemple

L'exemple suivant montre comment construire un objet avec de la classe d' CMFCToolBarMenuButton . Cet extrait de code fait partie d' Exemple de protection de Word.

  CMFCToolBarMenuButton* pBorderType = new 
        CMFCToolBarMenuButton (ID_BORDER_1, pPopup->GetSafeHmenu (),
        GetCmdMgr ()->GetCmdImage  (ID_BORDER_1, FALSE),
        _T("Borders"));

Configuration requise

en-tête : afxtoolbarmenubutton.h

Voir aussi

Référence

CMFCToolBarMenuButton, classe

Graphique de la hiérarchie

CMFCToolBarImages, classe