次の方法で共有


CMFCToolBar::SetUserImages

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

static BOOL SetUserImages(
   CMFCToolBarImages* pUserImages 
);

パラメーター

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

戻り値

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

解説

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

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

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

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

必要条件

ヘッダー : afxtoolbar.h

参照

関連項目

CMFCToolBar クラス

階層図

CMFCToolBarImages クラス

CMFCToolBar::GetUserImages