次の方法で共有


CMFCToolBar::ReplaceButton

更新 : 2007 年 11 月

ツール バー ボタンを別のツール バー ボタンに置き換えます。

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

パラメータ

  • [入力] uiCmd
    置き換えるボタンのコマンド ID。

  • [入力] button
    挿入する CMFCToolBarButton への参照。

  • [入力] bAll
    uiCmd で指定されたコマンド ID を持つすべてのボタンを置き換えるかどうかを指定するブール値。このパラメータが TRUE の場合、指定されたコマンド ID を持つすべてのボタンが置き換えられます。それ以外の場合は、最初のボタンが置き換えられます。

戻り値

置き換えられるボタンの数。このメソッドは、指定されたコマンド ID を持つボタンがツール バーに存在しない場合は 0 を返します。

解説

リソースから読み込むことができないツール バー ボタンを追加するには、このメソッドを呼び出します。デザイン時にプレースホルダのボタンを作成し、ツール バーを初期化するときに、そのボタンをカスタム ボタンに置き換えることができます。このメソッドの使用例については、VisualStudioDemo サンプルを参照してください。

使用例

次の例は、CMFCToolBar クラスでの ReplaceButton メソッドの使用方法を説明しています。このコード スニペットは、「IEDemo サンプル : 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));

必要条件

ヘッダー : afxtoolbar.h

参照

概念

MFC 階層図

参照

CMFCToolBar クラス

CMFCToolBarButton クラス