CMFCToolBar::ReplaceButton

Artigo
06/10/2015

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

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

Parâmetros

[in] uiCmd
A identificação de O comando do botão como substituir.
[in] button
Uma referência a CMFCToolBarButton inserção.
[in] bAll
Um valor Booleano que especifica se substitua todos os botões têm que a identificação do comando especificado por uiCmd. Se esse parâmetro é TRUE, todos os botões têm que o especificado identificação de comando 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 identificação de comando especificado não existir na barra de ferramentas.

Comentários

Chamar este método quando você deseja adicionar botões da barra de ferramentas que não podem ser carregados de recursos. Você pode criar um botão de espaço reservado em tempo de design e substituir esse botão com um botão personalizado quando você inicializa a barra de ferramentas. Consulte o exemplo de VisualStudioDemo para um exemplo que use este método.

Exemplo

O exemplo seguinte demonstra como usar o método de ReplaceButton na classe de CMFCToolBar . Este trecho de código é parte de Exemplo de demonstração de IE.

   CMFCToolBar     m_wndToolBar;


...


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