Partilhar via


CMFCToolBarsCustomizeDialog::AddToolBar

Carrega uma barra de ferramentas de recursos.Então, para cada comando no menu chama o CMFCToolBarsCustomizeDialog::AddButton método para inserir um botão na lista de comandos na Comandos página na categoria especificada.

BOOL AddToolBar(
   UINT uiCategoryId,
   UINT uiToolbarResId 
);
BOOL AddToolBar(
   LPCTSTR lpszCategory,
   UINT uiToolbarResId 
);

Parâmetros

  • [in] uiCategoryId
    Especifica a ID de recurso da categoria para a barra de ferramentas para adicionar.

  • [in] uiToolbarResId
    Especifica a ID de recurso de uma barra de ferramentas cujos comandos são inseridos na lista de comandos.

  • [in] lpszCategory
    Especifica o nome da categoria à qual adicionar a barra de ferramentas.

Valor de retorno

TRUE Se o método for bem-sucedida; caso contrário FALSE.

Exemplo

O exemplo a seguir demonstra como usar o AddToolBar método na CMFCToolBarsCustomizeDialog classe. Neste trecho de código faz parte o Exemplo do WordPad: Aplicativo WordPad do MFC.

    CMFCToolBarsCustomizeDialog* pDlgCust = new CMFCToolBarsCustomizeDialog (this,
        TRUE /* Automatic menus scaning */,
        AFX_CUSTOMIZE_MENU_SHADOWS | AFX_CUSTOMIZE_TEXT_LABELS | 
        AFX_CUSTOMIZE_MENU_ANIMATIONS);

    pDlgCust->AddToolBar (_T("Format"), IDR_FORMATBAR);

Comentários

O controle que é usado para representar cada comando é um Classe CMFCToolBarButton objeto. Depois de adicionar a barra de ferramentas, você pode substituir o botão com um controle de um tipo derivado chamando CMFCToolBarsCustomizeDialog::ReplaceButton.

Requisitos

Cabeçalho: afxToolBarsCustomizeDialog.h

Consulte também

Conceitos

Gráfico de hierarquia do MFC

Referência

Classe CMFCToolBarsCustomizeDialog