次の方法で共有


CMFCToolBar::SetUserImages

更新 : 2007 年 11 月

アプリケーションにおけるユーザー定義のイメージのコレクションを設定します。

static BOOL SetUserImages(
      CMFCToolBarImages* pUserImages 
);

パラメータ

  • [入力] pUserImages
    ユーザー定義イメージのコレクションへのポインタ。

戻り値

メソッドが正常終了した場合は 0 以外。それ以外で、指定されたCMFCToolBarImages オブジェクトが無効な場合、またはイメージのサイズがツール バーの既定のサイズと異なる場合は 0。

解説

フレームワークは、ユーザーによってカスタマイズされたツール バー ボタンのユーザー定義イメージを使用します。pUserImages で指定されるイメージ リストは、アプリケーション内のすべてのツール バーで共有されます。

指定されたCMFCToolBarImages オブジェクトが無効な場合、またはイメージのサイズがツール バーの既定のサイズと異なる場合には、このメソッドはデバッグ ビルドのアサーション エラーを生成します。

OutlookDemo、ToolTipDemo、および VisualStudioDemo の各サンプルは、このメソッドを使用してユーザー定義イメージのグローバル コレクションを設定します。これらのサンプルは UserImages.bmp という名前のファイルを読み込みます。このファイルはアプリケーションの作業ディレクトリにあります。

アプリケーションにおけるユーザー定義のイメージのコレクションを取得するには、CMFCToolBar::GetUserImages メソッドを呼び出します。

必要条件

ヘッダー : afxtoolbar.h

参照

概念

MFC 階層図

参照

CMFCToolBar クラス

CMFCToolBarImages クラス

CMFCToolBar::GetUserImages