CMFCToolBar::ReplaceButton

Substitui um botão de barra de ferramentas com outro botão de barra de ferramentas.

int ReplaceButton(
   UINT uiCmd,
   const CMFCToolBarButton& button,
   BOOL bAll=FALSE 
);

Parâmetros

  • [in] uiCmd
    A ID de comando do botão para substituir.

  • [in] button
    Uma referência para o CMFCToolBarButton Para inserir.

  • [in] bAll
    Um valor booliano que especifica se você deseja substituir todos os botões que possuem a ID de comando especificada por uiCmd. Se esse parâmetro for TRUE, todos os botões que possuem a ID de comando especificado são substituídos. Caso contrário, o primeiro botão é substituído.

Valor de retorno

O número de botões que são substituídos.Esse método retorna 0 se um botão com a ID de comando especificado não existe na barra de ferramentas.

Comentários

telefonar Esse método quando desejar adicionar botões de barra de ferramentas que não pode ser carregado de recursos.Você pode criar um botão de espaço reservado no time de design e substituir esse botão com um botão personalizado ao inicializar a barra de ferramentas.Consulte o exemplo VisualStudioDemo para obter um exemplo que usa esse método.

Exemplo

O exemplo a seguir demonstra como usar o ReplaceButton método na CMFCToolBar classe. Neste trecho de código faz parte o Exemplo do IEDemo: Aplicativo do MFC Internet Explorer.

    CMFCToolBar     m_wndToolBar;


...


        // CMenu menuHistory
        // CString str
        m_wndToolBar.ReplaceButton (ID_GO_BACK, 
            CMFCToolBarMenuButton (ID_GO_BACK, menuHistory, 
                        GetCmdMgr ()->GetCmdImage (ID_GO_BACK), str));

Requisitos

Cabeçalho: afxtoolbar.h

Consulte também

Conceitos

Gráfico de hierarquia do MFC

Referência

Classe CMFCToolBar

Classe CMFCToolBarButton