Partilhar via


CMFCToolBarsCustomizeDialog::AddButton

Insere um botão de barra de ferramentas na lista dos comandos no Comandos página.

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 de categoria na qual inserir o botão.

  • [in] button
    Especifica o botão para inserir.

  • [in] iInsertBefore
    Especifica o índice baseado em zero de um botão de barra de ferramentas antes que o botão é inserido.

  • [in] lpszCategory
    Especifica a seqüência de categoria para inserir o botão.

Comentários

The AddButton método ignora botões que têm sistema autônomo IDs de comando padrão (sistema autônomo ID_FILE_MRU_FILE1), que não são permitidos (consulte sistema autônomo comandos CMFCToolBar::IsCommandPermitted) e simular botões.

Esse método cria um novo objeto do mesmo tipo de button (geralmente um Classe CMFCToolBarButton), usando a classe em tempo de execução do botão. Em seguida, ele chama CMFCToolBarButton::CopyFrom Para copiar os membros de dados de botão e insere a cópia na categoria especificada.

Quando é inserido no novo botão, ele recebe o OnAddToCustomizePage notificação.

If iInsertBefore é -1, o botão é acrescentado à lista de categorias; caso contrário, ele é inserido antes do item com o índice especificado.

Exemplo

O exemplo a seguir demonstra como usar o AddButton método para o CMFCToolBarsCustomizeDialog classe. Neste trecho de código faz parte o Exemplo do controle deslizante: Aplicativo do MFC barra de ferramentas controle deslizante.

  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

Consulte também

Conceitos

Gráfico de hierarquia do MFC

Referência

Classe CMFCToolBarsCustomizeDialog