CMFCToolBarsCustomizeDialog::AddButton
Inserisce un pulsante della barra degli strumenti nell'elenco dei controlli nella pagina Comandi.
void AddButton(
UINT uiCategoryId,
const CMFCToolBarButton& button,
int iInsertBefore=-1
);
void AddButton(
LPCTSTR lpszCategory,
const CMFCToolBarButton& button,
int iInsertBefore=-1
);
Parametri
[in] uiCategoryId
Specifica l'id di categoria in cui inserire il pulsante.[in] button
Specifica il pulsante per inserire.[in] iInsertBefore
Specifica l'indice in base zero di un pulsante della barra degli strumenti prima della quale il pulsante verrà inserito.[in] lpszCategory
Specifica la stringa di categoria per inserire il pulsante.
Note
Il metodo AddButton ignora i pulsanti con gli ID di comando standard (ad esempio ID_FILE_MRU_FILE1), controlli che non sono consentiti (vedere CMFCToolBar::IsCommandPermitted) e pulsanti fittizi.
Questo metodo crea un nuovo oggetto dello stesso tipo button (in genere Classe CMFCToolBarButton) tramite la classe di runtime del pulsante. Chiama quindi CMFCToolBarButton::CopyFrom per copiare i membri dati del pulsante e inserisce la copia nella categoria specificata.
Quando il nuovo pulsante viene inserito, riceve la notifica OnAddToCustomizePage.
Se iInsertBefore è -1, il pulsante è connesso all'elenco di categorie; in caso contrario viene inserito prima che l'elemento all'indice specificato.
Esempio
Il seguente esempio viene illustrato come utilizzare il metodo AddButton della classe CMFCToolBarsCustomizeDialog. Questo frammento di codice fa parte Esempio slider.
CMFCToolBarsCustomizeDialog* pDlgCust = new CMFCToolBarsCustomizeDialog (this,
TRUE /* Automatic menus scaning */);
CSliderButton btnSlider (ID_SLIDER);
btnSlider.SetRange (0, 100);
pDlgCust->AddButton (_T("Edit"), btnSlider);
Requisiti
intestazione: afxToolBarsCustomizeDialog.h