CMFCToolBar::ReplaceButton

Article
06/10/2015

Remplace un bouton de barre d'outils avec un autre bouton de barre d'outils.

int ReplaceButton(
   UINT uiCmd,
   const CMFCToolBarButton& button,
   BOOL bAll=FALSE 
);

Paramètres

[in] uiCmd
L'ID de commande du bouton à remplacer.
[in] button
Une référence à CMFCToolBarButton à insérer.
[in] bAll
Valeur booléenne qui spécifie si remplacer tous les boutons ayant l'ID de commande spécifié par uiCmd. Si ce paramètre est TRUE, tous les boutons ayant l'ID de commande spécifiée sont remplacés. Sinon, le premier bouton est remplacé.

Valeur de retour

Le nombre de boutons qui sont substitués. Cette méthode retourne 0 si un bouton avec l'ID de commande spécifié n'existe pas dans la barre d'outils.

Notes

Appelez cette méthode lorsque vous voulez ajouter des boutons de barre d'outils qui ne peuvent pas être chargés de ressources. Vous pouvez créer un bouton de l'espace réservé au moment de le design et remplacer ce bouton avec un bouton personnalisé lorsque vous initialisez la barre d'outils. Consultez l'exemple VisualStudioDemo pour obtenir un exemple qui utilise cette méthode.

Exemple

L'exemple suivant montre comment utiliser la méthode d' ReplaceButton dans la classe d' CMFCToolBar . Cet extrait de code fait partie d' Exemple de démonstration d'IE.

 CMFCToolBar     m_wndToolBar;


...


        // CMenu menuHistory 
        // CString str
        m_wndToolBar.ReplaceButton (ID_GO_BACK, 
            CMFCToolBarMenuButton (ID_GO_BACK, menuHistory, 
                        GetCmdMgr ()->GetCmdImage (ID_GO_BACK), str));