CMFCToolBar::ReplaceButton

發行項
02/28/2013

用另一個工具列按鈕取代工具列按鈕。

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

參數

[in] uiCmd
要取代之按鈕的命令 ID。
[in] button
為 CMFCToolBarButton 的參考給外掛程式。
[in] bAll
指定是否要取代所有按鈕的命令 ID 的布林值。 uiCmd指定。如果此參數為 TRUE，具有指定的命令 ID 的任何按鈕取代。否則，第一個按鈕取代。

傳回值

取代的按鈕數目。如果指定的命令 ID 的一個工具列的按鈕不存在，這個方法會傳回 0。

備註

請呼叫這個方法，在您想要將無法從資源載入的工具列按鈕時。當您使用工具列時，您可以建立預留位置按鈕在設計階段和使用自訂按鈕取代該按鈕。使用這個方法的範例參閱 VisualStudioDemo 範例。

範例

下列範例會在 CMFCToolBar 類別會示範如何使用 ReplaceButton 方法。這個程式碼片段是 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));