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