CMFCToolBarsCustomizeDialog::AddButton
Insère un bouton de barre d'outils dans la liste des commandes dans la page Commandes .
void AddButton(
UINT uiCategoryId,
const CMFCToolBarButton& button,
int iInsertBefore=-1
);
void AddButton(
LPCTSTR lpszCategory,
const CMFCToolBarButton& button,
int iInsertBefore=-1
);
Paramètres
[in] uiCategoryId
Spécifie l'ID de catégorie dans lequel insérer le bouton.[in] button
Spécifie le bouton pour insérer.[in] iInsertBefore
Spécifie l'index de base zéro d'un bouton de barre d'outils avant lequel le bouton est inséré.[in] lpszCategory
Spécifie la chaîne de catégorie pour insérer le bouton.
Notes
La méthode d' AddButton ignore les boutons dont les ID de commande standard (tels qu'ID_FILE_MRU_FILE1), les commandes qui ne sont pas autorisées (consultez CMFCToolBar::IsCommandPermitted) et les boutons fictifs.
Cette méthode crée un objet du même type que button (généralement Classe de CMFCToolBarButton) à l'aide de la classe de runtime du bouton.Il appelle ensuite CMFCToolBarButton::CopyFrom pour copier les données membres du bouton, et insère la copie dans la catégorie spécifiée.
Lorsque le nouveau bouton est inséré, il reçoit une notification d' OnAddToCustomizePage .
Si iInsertBefore est -1, le bouton est ajouté à la liste de catégories ; sinon il est inséré avant l'élément à l'index spécifié.
Exemple
L'exemple suivant montre comment utiliser la méthode d' AddButton de classe d' CMFCToolBarsCustomizeDialog .Cet extrait de code fait partie d' Exemple slider.
CMFCToolBarsCustomizeDialog* pDlgCust = new CMFCToolBarsCustomizeDialog (this,
TRUE /* Automatic menus scaning */);
CSliderButton btnSlider (ID_SLIDER);
btnSlider.SetRange (0, 100);
pDlgCust->AddButton (_T("Edit"), btnSlider);
Configuration requise
en-tête : afxToolBarsCustomizeDialog.h