CMFCToolBarsCustomizeDialog::AddToolBar

更新 : 2007 年 11 月

リソースからツール バーを読み込みます。その後、メニュー内の各コマンドについて、CMFCToolBarsCustomizeDialog::AddButton メソッドを呼び出して、指定したカテゴリの下の [コマンド] ページのコマンドの一覧にボタンを挿入します。

BOOL AddToolBar(
   UINT uiCategoryId,
   UINT uiToolbarResId 
);
BOOL AddToolBar(
   LPCTSTR lpszCategory,
   UINT uiToolbarResId 
);

パラメータ

  • [入力] uiCategoryId
    ツール バーを追加する先のカテゴリのリソース ID を指定します。

  • [入力] uiToolbarResId
    コマンドの一覧に挿入するコマンドのあるツール バーのリソース ID を指定します。

  • [入力] lpszCategory
    ツール バーを追加する先のカテゴリの名前を指定します。

戻り値

このメソッドが成功した場合は TRUE。それ以外の場合は FALSE。

使用例

CMFCToolBarsCustomizeDialog クラスの AddToolBar メソッドの使用方法を次の例に示します。このコード スニペットは、「WordPad サンプル : MFC ワードパッド アプリケーション」の一部です。

  CMFCToolBarsCustomizeDialog* pDlgCust = new CMFCToolBarsCustomizeDialog (this,
        TRUE /* Automatic menus scaning */,
        AFX_CUSTOMIZE_MENU_SHADOWS | AFX_CUSTOMIZE_TEXT_LABELS | 
        AFX_CUSTOMIZE_MENU_ANIMATIONS);

    pDlgCust->AddToolBar (_T("Format"), IDR_FORMATBAR);

解説

各コマンドを表すために使用されるコントロールは、CMFCToolBarButton クラス オブジェクトです。ツール バーを追加した後、CMFCToolBarsCustomizeDialog::ReplaceButton を呼び出して、ボタンを派生型のコントロールに置き換えることができます。

必要条件

ヘッダー : afxToolBarsCustomizeDialog.h

参照

概念

MFC 階層図

参照

CMFCToolBarsCustomizeDialog クラス