CMFCToolBarsCustomizeDialog::AddButton
Insere um botão da barra de ferramentas na lista de comandos na página de Comandos .
void AddButton(
UINT uiCategoryId,
const CMFCToolBarButton& button,
int iInsertBefore=-1
);
void AddButton(
LPCTSTR lpszCategory,
const CMFCToolBarButton& button,
int iInsertBefore=-1
);
Parâmetros
[in] uiCategoryId
Especifica a ID da categoria para inserir o botão.[in] button
Especifica o botão para inserir.[in] iInsertBefore
Especifica o índice com base zero de um botão da barra de ferramentas antes do botão é inserido.[in] lpszCategory
Especifica a cadeia de caracteres de categoria para inserir o botão.
Comentários
O método de AddButton ignora os botões que tenham identificações padrões de comando (como ID_FILE_MRU_FILE1), os comandos que não são permitidos (consulte) CMFCToolBar::IsCommandPermittedos botões e fictícios.
Este método cria um novo objeto do mesmo tipo que button (geralmente Classe de CMFCToolBarButton) usando a classe em tempo de execução do botão.Chamamos CMFCToolBarButton::CopyFrom para copiar os membros de dados do botão, e inserir a cópia na categoria especificada.
Quando o novo botão é inserido, recebe notificação de OnAddToCustomizePage .
Se iInsertBefore é -1, o botão é acrescentado à lista de categorias; se não é inserido antes do item com o índice especificado.
Exemplo
O exemplo seguinte demonstra como usar o método de AddButton da classe de CMFCToolBarsCustomizeDialog .Este trecho de código é parte de Exemplo de controle slider.
CMFCToolBarsCustomizeDialog* pDlgCust = new CMFCToolBarsCustomizeDialog (this,
TRUE /* Automatic menus scaning */);
CSliderButton btnSlider (ID_SLIDER);
btnSlider.SetRange (0, 100);
pDlgCust->AddButton (_T("Edit"), btnSlider);
Requisitos
Cabeçalho: afxToolBarsCustomizeDialog.h