CMFCToolBar::ReplaceButton

Статья
06/10/2015

Заменяет кнопка панели инструментов с кнопкой панели инструментов.

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

Параметры

[входящий] uiCmd
Идентификатор команды кнопки, который требуется заменить.
[входящий] button
Ссылка на CMFCToolBarButton для вставки.
[входящий] bAll
Логическое значение, которое определяет, следует ли заменить все кнопки, которые имеют идентификатор команды, uiCmd. Если этот параметр TRUE, то все кнопки с указанным идентификатором команды заменены. В противном случае - первая кнопка заменена.

Возвращаемое значение

Число кнопок, заменены. Этот метод возвращает 0, если кнопка с указанным идентификатором команды не существует на панели инструментов.

Заметки

Вызовите этот метод, если требуется добавить кнопки панели инструментов, которые невозможно загрузить из ресурсов. Можно создать кнопку placeholder во время разработки и заменить что кнопка с пользовательской кнопкой при инициализации панели инструментов. См. образец VisualStudioDemo пример, в котором используется этот метод.

Пример

В следующем примере показано, как использовать метод ReplaceButton в классе CMFCToolBar. Этот фрагмент кода является частью Пример demo 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));