CMFCToolBarImages クラス

[アーティクル]
08/04/2024

ツールバー上の画像。 CMFCToolBarImages クラスは、アプリケーションリソースまたはファイルから読み込まれたツールバーイメージを管理します。詳細については、Visual Studio のインストールの VC\atlmfc\src\mfc フォルダーにあるソースコードを参照してください。

構文

class CMFCToolBarImages : public CObject

メンバー

パブリックコンストラクター

名前	説明
CMFCToolBarImages::CMFCToolBarImages	`CMFCToolBarImages` オブジェクトを構築します。

パブリックメソッド

名前	説明
CMFCToolBarImages::AdaptColors
CMFCToolBarImages::AddIcon	ツールバーイメージにアイコンを追加します。
CMFCToolBarImages::AddImage	ツールバーイメージにビットマップを追加します。
CMFCToolBarImages::CleanUp
CMFCToolBarImages::Clear	このオブジェクトに割り当てられたシステムリソースを解放します。
CMFCToolBarImages::ConvertTo32Bits	下線付きビットマップを 32 bpp イメージに変換します。
CMFCToolBarImages::CopyImageToClipboard
CMFCToolBarImages::CopyTo
CMFCToolBarImages::CreateFromImageList	イメージリスト ( CImageList クラス) からツールバーイメージを初期化します。
CMFCToolBarImages::CreateRegionFromImage
CMFCToolBarImages::D eleteImage	このツールバーイメージのセットにユーザー定義イメージが含まれている場合は、指定したインデックスを持つイメージをツールバーイメージから削除します。
CMFCToolBarImages::D raw	1 つのツールバーイメージ (ボタン) を描画します。
CMFCToolBarImages::D rawEx
CMFCToolBarImages::EnableRTL
CMFCToolBarImages::EndDrawImage	ツールバーイメージの描画後にシステムリソースを解放します。
CMFCToolBarImages::ExtractIcon	ツールバーイメージから、指定したイメージインデックスを持つアイコンを返します。
CMFCToolBarImages::FillDitheredRect	ツールバーの背景色を持つブラシを使用して四角形を塗りつぶします。
CMFCToolBarImages::GetAlwaysLight
CMFCToolBarImages::GetBitsPerPixel	下線付き画像の現在の解像度を返します。
CMFCToolBarImages::GetCount	ツールバーの画像の数を返します。
CMFCToolBarImages::GetDisabledImageAlpha	無効なイメージに使用されるアルファチャネル値を返します。
CMFCToolBarImages::GetFadedImageAlpha
CMFCToolBarImages::GetImageSize	メモリに格納されているツールバーイメージのサイズ (ソースサイズ) または画面に描画されるツールバーイメージのサイズ (コピー先のサイズ) を取得します。
CMFCToolBarImages::GetImageWell	すべてのツールバーイメージを含むビットマップへのハンドルを返します。
CMFCToolBarImages::GetImageWellLight
CMFCToolBarImages::GetLastImageRect
CMFCToolBarImages::GetLightPercentage
CMFCToolBarImages::GetMapTo3DColors
CMFCToolBarImages::GetMask
CMFCToolBarImages::GetResourceOffset	指定したリソース ID のイメージインデックスを返します。
CMFCToolBarImages::GetScale	下線付き画像の現在のスケール比を返します。
CMFCToolBarImages::GetTransparentColor
CMFCToolBarImages::GrayImages	ツールバーの画像を灰色にして、無効に見えるようにします。
CMFCToolBarImages::Is32BitTransparencySupported	オペレーティングシステムが 32 ビットアルファブレンドをサポートするかどうかを決定します。
CMFCToolBarImages::IsPreMultiplyAutoCheck
CMFCToolBarImages::IsRTL	右から左 (RTL) のサポートが有効かどうかを判断します。
CMFCToolBarImages::IsReadOnly	ツールバーイメージが読み取り専用かどうかを決定します。
CMFCToolBarImages::IsScaled	下線付きイメージを拡大縮小するかどうかを示します。
CMFCToolBarImages::IsUserImagesList	このツールバーイメージのセットにユーザー定義イメージが含まれているかどうかを判断します。
CMFCToolBarImages::IsValid	このツールバーイメージのセットに有効なツールバーイメージが含まれているかどうかを判断します。
CMFCToolBarImages::Load	システムリソースまたはファイルからツールバーイメージを読み込みます。
CMFCToolBarImages::LoadStr
CMFCToolBarImages::MapFromSysColor
CMFCToolBarImages::MapTo3dColors
CMFCToolBarImages::MapToSysColor
CMFCToolBarImages::MapToSysColorAlpha
CMFCToolBarImages::Mirror	すべてのツールバーイメージを水平方向にミラー化します。
CMFCToolBarImages::MirrorBitmap	ビットマップを水平方向にミラー化します。
CMFCToolBarImages::MirrorBitmapVert
CMFCToolBarImages::MirrorVert
CMFCToolBarImages::OnSysColorChange
CMFCToolBarImages::P repareDrawImage	指定したサイズでツールバーイメージを描画するために必要なリソースを割り当てます。
CMFCToolBarImages::Save	ツールバーイメージのこのセットにユーザー定義イメージが含まれている場合は、ツールバーイメージをファイルに格納します。
CMFCToolBarImages::SetAlwaysLight
CMFCToolBarImages::SetDisabledImageAlpha	無効なイメージに使用されるアルファチャネル値を設定します。
CMFCToolBarImages::SetFadedImageAlpha
CMFCToolBarImages::SetImageSize	ツールバーイメージのサイズ (ソースサイズ) を設定します。
CMFCToolBarImages::SetLightPercentage
CMFCToolBarImages::SetMapTo3DColors
CMFCToolBarImages::SetPreMultiplyAutoCheck
CMFCToolBarImages::SetSingleImage
CMFCToolBarImages::SetTransparentColor	ツールバーイメージの透明な色を設定します。
CMFCToolBarImages::SmoothResize	下線付き画像のサイズをスムーズに変更します。
CMFCToolBarImages::UpdateImage	ビットマップからユーザー定義ツールバーイメージを更新します。

保護メソッド

名前	説明
CMFCToolBarImages::P reMultiplyAlpha

データメンバー

名前	説明
CMFCToolBarImages::m_bDisableTrueColorAlpha	truecolor アルファブレンド (32 ビットカラー) が無効になっている場合は TRUE。

解説

CMFCToolbarImagesによって管理されるツールバーイメージの完全なビットマップは、固定サイズの 1 つ以上の小さなツールバーイメージ (ボタン) で構成されます。

例

次の例では、CMFCToolBarImages クラスのさまざまなメソッドを使用してCMFCToolBarImages オブジェクトを構成する方法を示します。この例では、ツールバーイメージのサイズを設定し、イメージを読み込み、イメージの透明な色を設定する方法を示します。このコードスニペットは、Visual Studio デモサンプルの一部です。

CMFCToolBarImages m_Image;

m_Image.SetImageSize(CSize(32, 32));
m_Image.Load(IDR_START);
m_Image.SetTransparentColor(RGB(255, 0, 255));

継承階層

CObject

CMFCToolBarImages

要件

Header: afxtoolbarimages.h

CMFCToolBarImages::AdaptColors

void AdaptColors(
    COLORREF clrBase,
    COLORREF clrTone);

パラメーター

[入力] clrBase
[入力] clrTone

解説

CMFCToolBarImages::AddIcon

ツールバーイメージの一覧にアイコンを追加します。

int AddIcon(
    HICON hIcon,
    BOOL bAlphaBlend=FALSE);

パラメーター

hIcon
[in] 追加されるアイコンへのハンドル。

bAlphaBlend
[in]このアイコンをアルファブレンドと共に使用する場合は TRUE。それ以外の場合は FALSE。

戻り値

メソッドが成功した場合に追加されたツールバーイメージの 0 から始まるインデックス。それ以外の場合は -1。

CMFCToolBarImages::AddImage

ツールバーイメージにビットマップを追加します。

int AddImage(
    HBITMAP hbmp,
    BOOL bSetBitPerPixel=FALSE);

int AddImage(
    const CMFCToolBarImages& imageList,
    int nIndex);

パラメーター

hbmp
[in]追加するビットマップへのハンドル。

bSetBitPerPixel
[in] CMFCToolBarImages オブジェクトが新しいイメージの色深度 (ピクセルあたりのビット数) を使用する場合は TRUE。 CMFCToolbarImages オブジェクトが現在の色深度を保持する場合は FALSE。

imageList
[in]追加するイメージを含む CMFCToolbarImages オブジェクトへの参照。

nIndex
[in]追加するイメージのソース CMFCToolbarImages オブジェクト内のインデックス。

戻り値

新しいビットマップが正常に追加された後、 CMFCToolBarImages オブジェクトが保持するツールバーイメージの数。操作が失敗した場合は -1。

CMFCToolBarImages::CleanUp

static void __stdcall CleanUp();

解説

CMFCToolBarImages::Clear

CMFCToolbarImages オブジェクトが割り当てたシステムリソースを解放します。

void Clear();

CMFCToolBarImages::CMFCToolBarImages

CMFCToolBarImages オブジェクトを構築します。

CMFCToolBarImages();

解説

CMFCToolBarImages オブジェクトを構築し、レンダリングエンジンを初期化し、イメージサイズを既定値の 16 x 15 ピクセルに設定します。 CMFCToolBarImages::SetImageSize を使用して、イメージを追加する前にイメージのサイズを変更します。

CMFCToolBarImages::CopyImageToClipboard

BOOL CopyImageToClipboard(int iImage);

パラメーター

[入力] iImage

戻り値

解説

CMFCToolBarImages::CopyTo

BOOL CopyTo(CMFCToolBarImages& imageList);

パラメーター

[入力] imageList

戻り値

解説

CMFCToolBarImages::CreateFromImageList

CImageList クラスオブジェクトからツールバーイメージを初期化します。

BOOL CreateFromImageList(const CImageList& imageList);

パラメーター

imageList
[in]ツールバーイメージのソースとして使用するイメージリスト。

戻り値

常に TRUE が返されます。

解説

この関数を使用すると、ツールバーイメージリストを外部イメージリストから簡単に初期化できます。

CMFCToolBarImages::CreateRegionFromImage

static HRGN __stdcall CreateRegionFromImage(
    HBITMAP bmp,
    COLORREF clrTransparent);

パラメーター

[入力] bmp
[入力] clrTransparent

戻り値

解説

CMFCToolBarImages::D eleteImage

指定したインデックスを持つユーザー定義イメージをツールバーイメージから削除します。

BOOL DeleteImage(int iImage);

パラメーター

iImage
[in]削除するイメージの 0 から始まるインデックスを指定します。

戻り値

イメージが正常に削除された場合は TRUE。イメージインデックスが無効な場合、 CMFCToolbarImages オブジェクトが一時的な場合、 CMFCToolbarImages オブジェクトにユーザー定義イメージが含まれていない場合、または他のエラーが発生した場合は FALSE。

CMFCToolBarImages::D raw

1 つのツールバーイメージを描画します。

BOOL Draw(
    CDC* pDC,
    int x,
    int y,
    int iImageIndex,
    BOOL bHilite=FALSE,
    BOOL bDisabled=FALSE,
    BOOL bIndeterminate=FALSE,
    BOOL bShadow=FALSE,
    BOOL bInactive=FALSE,
    BYTE alphaSrc=255);

パラメーター

pDC
[入力] デバイスコンテキストへのポインター。

x
[in]画像を描画する四角形の左側の X 座標。

y
[in]画像を描画する四角形の上部の Y 座標。

iImageIndex
[in]表示するイメージの 0 から始まるインデックス。

bHilite
[in]画像が強調表示される場合は TRUE。それ以外の場合は FALSE。

bDisabled
[in]イメージを無効なスタイルで描画する場合は TRUE。それ以外の場合は FALSE。

bIndeterminate
[in]イメージを不確定な状態スタイルで描画する場合は TRUE。それ以外の場合は FALSE。

bShadow
[in]イメージをドロップシャドウで描画する場合は TRUE。それ以外の場合は FALSE。

bInactive
[in]イメージを非アクティブな状態スタイルで描画する場合は TRUE。それ以外の場合は FALSE。

alphaSrc
[in]アルファチャネル (不透明度) の値。値 255 は、イメージが不透明に描画されていることを意味します。値 0 は、イメージが透明に描画されていることを意味します。この値は、32 ビットカラーイメージと、Windows Vista ガラススタイルを表示した画像にのみ使用されます。

戻り値

指定したイメージが正常に表示された場合は TRUE。イメージインデックスが無効であるか、他のエラーが発生した場合は FALSE。

CMFCToolBarImages::D rawEx

BOOL DrawEx(
    CDC* pDC,
    CRect rect,
    int iImageIndex,
    ImageAlignHorz horzAlign = ImageAlignHorzLeft,
    ImageAlignVert vertAlign = ImageAlignVertTop,
    CRect rectSrc = CRect(0, 0, 0, 0),
    BYTE alphaSrc = 255);

パラメーター

[入力] pDC
[in] rect
[入力] iImageIndex
[入力] horzAlign
[入力] vertAlign
[入力] rectSrc
[入力] alphaSrc

戻り値

解説

CMFCToolBarImages::EnableRTL

static void __stdcall EnableRTL(BOOL bIsRTL = TRUE);

パラメーター

[入力] bIsRTL

解説

CMFCToolBarImages::EndDrawImage

CMFCToolBarImages::D raw を呼び出してツールバーイメージを描画した後割り当てられた、CMFCToolBarImages::P repareDrawImages をするシステムリソースを解放します。

void EndDrawImage(CAfxDrawState& ds);

パラメーター

ds
[in]PrepareDrawImage メソッドに渡されたCAfxDrawState オブジェクトへの参照。

CMFCToolBarImages::ExtractIcon

ツールバーイメージから、指定したイメージインデックスを持つアイコンを返します。

HICON ExtractIcon(int nIndex);

パラメーター

nIndex
[in]アイコンとして抽出するイメージが配置されているイメージリスト内の 0 から始まるインデックス。

戻り値

抽出されたアイコンのハンドル。 nIndex が範囲外の場合は NULL。

CMFCToolBarImages::FillDitheredRect

四角形にツールバーの背景色を塗りつぶします。

static void FillDitheredRect(
    CDC* pDC,
    const CRect& rect);

パラメーター

pDC
[入力] デバイスコンテキストへのポインター。

rect
[in]塗りつぶす四角形の座標。

解説

このメソッドを使用して、COLOR_BTNFACEおよびCOLOR_BTNHIGHLIGHTシステムの色の平均である色で四角形を塗りつぶします。システムが 256 色以下を使用している場合、四角形は、代わりにこれら 2 つの色のディザスターパターンで塗りつぶされます。

CMFCToolBarImages::GetAlwaysLight

BOOL GetAlwaysLight() const;

戻り値

解説

CMFCToolBarImages::GetCount

ツールバーの画像の一覧の画像の数を返します。

int GetCount() const;

戻り値

CMFCToolBarImages オブジェクト内のイメージの数。

CMFCToolBarImages::GetDisabledImageAlpha

無効な画像に使用されるアルファチャネル (不透明度) の値を返します。

static BYTE GetDisabledImageAlpha();

戻り値

現在のアルファチャネル値。

解説

CMFCToolBarImages::SetDisabledImageAlpha を呼び出して、アルファチャネル値を変更できます。

CMFCToolBarImages::GetFadedImageAlpha

static BYTE __stdcall GetFadedImageAlpha();

戻り値

解説

CMFCToolBarImages::GetImageSize

メモリに格納されているツールバーイメージのサイズ (ソースサイズ) または画面に描画されるツールバーイメージのサイズ (コピー先のサイズ) を取得します。

SIZE GetImageSize(BOOL bDest=FALSE) const;

パラメーター

bDest
[in]宛先サイズを取得する場合は TRUE。ソースイメージのサイズを取得する場合は FALSE。

戻り値

イメージのサイズをピクセル単位で指定する SIZE 構造体。

解説

ソースイメージのサイズは、 CMFCToolbarImages オブジェクトに格納されているイメージのサイズです。 CMFCToolBarImages::SetImageSize を呼び出してソースサイズを設定できます。既定値は 16 x 15 ピクセルです。

既定では、コピー先のイメージサイズは0x0。宛先サイズは、 CMFCToolBarImages::P repareDrawImage を呼び出すときに指定します。 CMFCToolBarImages::EndDrawImage メソッドは、変換先のサイズを既定値にリセットします。

CMFCToolBarImages::GetImageWell

すべてのツールバーイメージを含むビットマップへのハンドルを返します。

HBITMAP GetImageWell() const;

戻り値

ツールバーイメージを含むビットマップへのハンドル。

解説

ツールバーイメージは、 イメージウェルと呼ばれる 1 つのビットマップ内の行に格納されます。イメージウェル内のツールバーイメージを検索するには、イメージのインデックスにツールバーイメージの幅 ( CMFCToolBarImages::GetImageSize を参照) を乗算して、画像ウェル内のイメージの水平方向のオフセットを取得します。

CMFCToolBarImages::GetImageWellLight

HBITMAP GetImageWellLight() const;

戻り値

解説

CMFCToolBarImages::GetLastImageRect

CRect GetLastImageRect() const;

戻り値

解説

CMFCToolBarImages::GetLightPercentage

int GetLightPercentage() const;

戻り値

解説

CMFCToolBarImages::GetMapTo3DColors

BOOL GetMapTo3DColors() const;

戻り値

解説

CMFCToolBarImages::GetMask

HBITMAP GetMask(int iImage);

パラメーター

[入力] iImage

戻り値

解説

CMFCToolBarImages::GetResourceOffset

指定したリソース ID のイメージインデックスを返します。

int GetResourceOffset(UINT uiResId) const;

パラメーター

uiResId
[in]イメージリソース ID。

戻り値

メソッドが成功した場合のイメージインデックス。指定したリソース ID を持つイメージが存在しない場合は -1。

CMFCToolBarImages::GetTransparentColor

COLORREF GetTransparentColor() const;

戻り値

解説

CMFCToolBarImages::GrayImages

ツールバーの画像を灰色にして、無効に見えるようにします。

BOOL GrayImages(int nGrayImageLuminancePercentage);

パラメーター

nGrayImageLuminancePercentage
[in]輝度の割合。

戻り値

コレクション内のイメージが正常に灰色表示された場合は TRUE。それ以外の場合は FALSE。

解説

このメソッドは、各ピクセルの赤、緑、青の各コンポーネントを平均化し、結果に nGrayImageLuminancePercentage を 100 で除算して、ツールバーイメージを変更します。 nGrayImageLuminancePercentage が 0 または負の場合は、既定値の 130 が代わりに使用されます。

Note

変更を元に戻す場合は、ソースからイメージを再読み込みする必要があります。これを行うには、 CMFCToolBarImages::Load または CMFCToolBarImages::UpdateImage (ユーザー定義イメージの場合のみ) を呼び出すか、 CM を呼び出します。FCToolBarImages::Clear 、 CMFCToolBarImages::AddIcon または CMFCToolBarImages::AddImage を呼び出してイメージを再度追加します。

CMFCToolBarImages::Is32BitTransparencySupported

オペレーティングシステムが 32 ビットアルファブレンドをサポートするかどうかを指定します。

static BOOL Is32BitTransparencySupported();

戻り値

32 ビットアルファブレンドがサポートされている場合は TRUE。それ以外の場合は FALSE。

解説

この静的メソッドを使用して、オペレーティングシステムが 32 ビットアルファブレンドをサポートしているかどうかを実行時に確認します。この機能は、Windows 2000 以降のバージョンでサポートされています。

CMFCToolBarImages::IsPreMultiplyAutoCheck

BOOL IsPreMultiplyAutoCheck() const;

戻り値

解説

CMFCToolBarImages::IsReadOnly

ツールバーイメージを読み取り専用にするかどうかを指定します。

BOOL IsReadOnly() const;

戻り値

ツールバーイメージが読み取り専用の場合は TRUE、それ以外の場合は FALSE。

解説

CMFCToolbarImages オブジェクトは、ツールバーイメージを含むビットマップが読み取り専用ファイルから読み込まれた場合、または CMFCToolBarImages::CopyTemp メソッドを使用してビットマップがコピーされた場合に読み取り専用です。

CMFCToolBarImages::IsRTL

右から左 (RTL) のサポートを有効にするかどうかを指定します。

static BOOL IsRTL();

戻り値

RTL サポートが有効な場合は TRUE。それ以外の場合は FALSE。

解説

RTL のサポートは、アプリケーションがアラビア語、ヘブライ語、ペルシャ語、ウルドゥー語など、右から左に読み取られた言語にローカライズされている場合に使用されます。

CMFCToolBarImages::IsUserImagesList

このツールバーイメージのセットにユーザー定義イメージが含まれているかどうかを指定します。

BOOL IsUserImagesList() const;

戻り値

CMFCToolBarImages オブジェクトにユーザー定義のツールバーイメージが含まれている場合は TRUE。それ以外の場合は FALSE。

CMFCToolBarImages::IsValid

このツールバーイメージのセットに有効なツールバーイメージが含まれているかどうかを示します。

BOOL IsValid() const;

戻り値

CMFCToolBarImages オブジェクトが有効な場合は TRUE、それ以外の場合は FALSE。

解説

ツールバーイメージを含むビットマップへのハンドルが NULL の場合、 CMFCToolBarImages オブジェクトは無効です。

CMFCToolBarImages::Load

システムリソースまたはファイルからツールバーイメージを読み込みます。

BOOL Load(
    UINT uiResID,
    HINSTANCE hinstRes=NULL,
    BOOL bAdd=FALSE);

BOOL Load(
    LPCTSTR lpszBmpFileName,
    DWORD nMaxFileSize = 819200);

パラメーター

uiResID
[in]ビットマップリソースの ID。

hinstRes
[in]リソース DLL のインスタンス。

bAdd
[in]読み込まれたビットマップを既存のビットマップに追加する場合は TRUE、既存のビットマップを置き換える場合は FALSE。

lpszBmpFileName
[in]ビットマップの読み込み元のディスクファイルへのパス。

nMaxFileSize
[in]ビットマップファイル内の最大バイト数。ファイルサイズに関係なくビットマップを読み込む場合は 0 です。ファイルのサイズがこの最大サイズを超える場合、メソッドは FALSE を返し、ビットマップは読み込まれません。

戻り値

ビットマップが正常に読み込まれた場合は TRUE。それ以外の場合は FALSE。

解説

ファイルに読み取り専用属性がある場合、イメージリストは読み取り専用としてマークされます。

CMFCToolBarImages::LoadStr

BOOL LoadStr(
    LPCTSTR lpszResourceName,
    HINSTANCE hinstRes = NULL,
    BOOL bAdd = FALSE);

パラメーター

[入力] lpszResourceName
[入力] hinstRes
[入力] bAdd

戻り値

解説

CMFCToolBarImages::MapFromSysColor

static COLORREF __stdcall MapFromSysColor(
    COLORREF color,
    BOOL bUseRGBQUAD = TRUE);

パラメーター

[入力] 色
[入力] bUseRGBQUAD

戻り値

解説

CMFCToolBarImages::MapTo3dColors

BOOL MapTo3dColors(
    BOOL bUseRGBQUAD = TRUE,
    COLORREF clrSrc = (COLORREF)-1,
    COLORREF clrDest = (COLORREF)-1);

パラメーター

[入力] bUseRGBQUAD
[入力] clrSrc
[入力] clrDest

戻り値

解説

CMFCToolBarImages::MapToSysColor

static COLORREF __stdcall MapToSysColor(
    COLORREF color,
    BOOL bUseRGBQUAD = TRUE);

パラメーター

[入力] 色
[入力] bUseRGBQUAD

戻り値

解説

CMFCToolBarImages::MapToSysColorAlpha

static COLORREF __stdcall MapToSysColorAlpha(COLORREF color);

パラメーター

[入力] 色

戻り値

解説

CMFCToolBarImages::Mirror

ツールバーイメージを水平ミラーイメージに置き換えます。

BOOL Mirror();

戻り値

イメージが正常にミラー化された場合は TRUE。それ以外の場合は FALSE。

解説

このメソッドは、右から左への書き込みシステムをサポートするために使用されます。

CMFCToolBarImages::MirrorBitmap

ビットマップを水平方向のミラーイメージに置き換えます。

static BOOL MirrorBitmap(
    HBITMAP& hbmp,
    int cxImage);

パラメーター

hbmp
[入力、出力]ミラー化するビットマップへのハンドル。

cxImage
[in]イメージの幅 (ピクセル単位)。

戻り値

イメージが正常にミラー化された場合は TRUE。それ以外の場合は FALSE。

解説

この関数は、右から左への書き込みシステムをサポートするために使用されます。

CMFCToolBarImages::MirrorBitmapVert

static BOOL __stdcall MirrorBitmapVert(
    HBITMAP& hbmp,
    int cyImage);

パラメーター

[入力] hbmp
[入力] cyImage

戻り値

解説

CMFCToolBarImages::MirrorVert

BOOL MirrorVert();

戻り値

解説

CMFCToolBarImages::OnSysColorChange

void OnSysColorChange();

解説

CMFCToolBarImages::P reMultiplyAlpha

static BOOL __stdcall PreMultiplyAlpha(
    HBITMAP hbmp,
    BOOL bAutoCheckPremlt);

BOOL PreMultiplyAlpha(HBITMAP hbmp);

パラメーター

[入力] hbmp
[入力] bAutoCheckPremlt

戻り値

解説

CMFCToolBarImages::m_bDisableTrueColorAlpha

truecolor アルファブレンド (32 ビットカラー) が無効になっている場合は TRUE。

static BOOL m_bDisableTrueColorAlpha;

解説

ツールバーイメージの truecolor アルファブレンドを有効にするには、このメンバー変数を FALSE に設定します。

下位互換性のために既定値は TRUE です。

CMFCToolBarImages::P repareDrawImage

指定したサイズでツールバーイメージを描画するために必要なリソースを割り当てます。

BOOL PrepareDrawImage(
    CAfxDrawState& ds,
    CSize sizeImageDest=CSize(0,
    0)
    BOOL bFadeInactive=FALSE);

パラメーター

ds
[in]イメージレンダリングステージ間で割り当てられたリソースを格納する CAfxDrawState 構造体への参照。

sizeImageDest
[in]コピー先イメージのサイズを指定します。

bFadeInactive
[in]非アクティブなイメージをフェードで描画する場合は TRUE。

戻り値

ツールバーイメージの描画に必要なリソースが正常に割り当てられた場合は TRUE、それ以外の場合は FALSE。

解説

このメソッドを呼び出した後、 CMFCToolBarImages::D raw を何度でも呼び出すことができます。描画が完了したら、 CMFCToolBarImages::EndDrawImage を呼び出して、 PrepareDrawImageによって割り当てられたリソースを解放する必要があります。

CMFCToolBarImages::Save

ツールバーイメージのこのセットにユーザー定義イメージが含まれている場合は、ツールバーイメージをファイルに格納します。

BOOL Save(LPCTSTR lpszBmpFileName=NULL);

パラメーター

lpszBmpFileName
ディスクファイルへのパス。

戻り値

ツールバーイメージが正常に保存された場合は TRUE。それ以外の場合は FALSE。

解説

このメソッドを呼び出して、ユーザー定義イメージをディスクファイルに格納します。 lpszBmpFileName が NULL の場合、メソッドはビットマップを、CMFCToolBarImages::Load メソッドによって読み込まれたファイルに格納します。

CMFCToolBarImages::SetAlwaysLight

void SetAlwaysLight(BOOL bAlwaysLight = TRUE);

パラメーター

[入力] bAlwaysLight

解説

CMFCToolBarImages::SetDisabledImageAlpha

無効なイメージに使用されるアルファチャネル (不透明度) の値を設定します。

static void SetDisabledImageAlpha(BYTE nValue);

パラメーター

nValue
[in]アルファチャネルの新しい値。

解説

無効なイメージのカスタムアルファ値を設定するには、このメソッドを使用します。既定値は 127 で、無効になっているボタンイメージは半透明になります。値を 0 に設定すると、無効になっているイメージは完全に透明になります。値を 255 に設定すると、無効になっているイメージは完全に不透明になります。

CMFCToolBarImages::SetFadedImageAlpha

static void __stdcall SetFadedImageAlpha(BYTE nValue);

パラメーター

[入力] nValue

解説

CMFCToolBarImages::SetImageSize

各ツールバーイメージのサイズ (ソースサイズ) を設定します。

void SetImageSize(
    SIZE sizeImage,
    BOOL bUpdateCount=FALSE);

パラメーター

sizeImage
[in]ツールバーイメージの新しいサイズ。

解説

既定では、ツールバーイメージのサイズは 16 x 15 ピクセルです。別のサイズのツールバーイメージを使用する場合は、このメソッドを呼び出します。

CMFCToolBarImages::SetLightPercentage

void SetLightPercentage(int nValue);

パラメーター

[入力] nValue

解説

CMFCToolBarImages::SetMapTo3DColors

void SetMapTo3DColors(BOOL bMapTo3DColors);

パラメーター

[入力] bMapTo3DColors

解説

CMFCToolBarImages::SetPreMultiplyAutoCheck

void SetPreMultiplyAutoCheck(BOOL bAuto = TRUE);

パラメーター

[入力] bAuto

解説

CMFCToolBarImages::SetSingleImage

void SetSingleImage();

解説

CMFCToolBarImages::SetTransparentColor

ツールバーイメージの透明な色を設定します。

COLORREF SetTransparentColor(COLORREF clrTransparent);

パラメーター

clrTransparent
[in]RGB 値。

戻り値

前の透明な色。

解説

ユーザーまたはフレームワークが CMFCToolBarImages::D raw を呼び出すと、メソッドは clrTransparent で指定された色に一致するピクセルを描画しません。

CMFCToolBarImages::UpdateImage

ビットマップからユーザー定義ツールバーイメージを更新します。

BOOL UpdateImage(
    int iImage,
    HBITMAP hbmp);

パラメーター

iImage
[in]更新するイメージの 0 から始まるインデックス。

hbmp
[in]イメージの更新元となるビットマップのハンドル。

戻り値

イメージが正常に更新された場合は TRUE。イメージリストがユーザー定義または一時的でない場合は FALSE。

CMFCToolBarImages::ConvertTo32Bits

下線付きビットマップを 32 bpp イメージに変換します。

BOOL ConvertTo32Bits(COLORREF clrTransparent = (COLORREF)-1);

パラメーター

clrTransparent
下線付きビットマップの透明な色を指定します。

解説

CMFCToolBarImages::GetBitsPerPixel

下線付き画像の現在の解像度を返します。

int GetBitsPerPixel() const;

戻り値

下線付き画像の現在の解像度をピクセルあたりのビット数 (bpp) で表す整数値。

解説

CMFCToolBarImages::GetScale

下線付き画像の現在のスケール比を返します。

double GetScale() const;

戻り値

現在のスケール比を表す値。

解説

CMFCToolBarImages::IsScaled

下線付きイメージを拡大縮小するかどうかを示します。

BOOL IsScaled () const;

戻り値

下線付きイメージが拡大縮小される場合は TRUE。それ以外の場合は FALSE。

解説

CMFCToolBarImages::SmoothResize

下線付き画像のサイズをスムーズに変更します。

BOOL SmoothResize(double dblImageScale);

パラメーター

dblImageScale
スケールの比率。

戻り値

サイズ変更に成功した場合は TRUE。それ以外の場合は FALSE。

次の方法で共有

CMFCToolBarImages クラス

構文

メンバー

パブリック コンストラクター

パブリック メソッド

保護メソッド

データ メンバー

解説

例

継承階層

要件

CMFCToolBarImages::AdaptColors

パラメーター

解説

CMFCToolBarImages::AddIcon

パラメーター

戻り値

CMFCToolBarImages::AddImage

パラメーター

戻り値

CMFCToolBarImages::CleanUp

解説

CMFCToolBarImages::Clear

CMFCToolBarImages::CMFCToolBarImages

解説

CMFCToolBarImages::CopyImageToClipboard

パラメーター

戻り値

解説

CMFCToolBarImages::CopyTo

パラメーター

戻り値

解説

CMFCToolBarImages::CreateFromImageList

パラメーター

戻り値

解説

CMFCToolBarImages::CreateRegionFromImage

パラメーター

戻り値

解説

CMFCToolBarImages::D eleteImage

パラメーター

戻り値

CMFCToolBarImages::D raw

パラメーター

戻り値

CMFCToolBarImages::D rawEx

パラメーター

戻り値

解説

CMFCToolBarImages::EnableRTL

パラメーター

解説

CMFCToolBarImages::EndDrawImage

パラメーター

CMFCToolBarImages::ExtractIcon

パラメーター

戻り値

CMFCToolBarImages::FillDitheredRect

パラメーター

解説

CMFCToolBarImages::GetAlwaysLight

戻り値

解説

CMFCToolBarImages::GetCount

戻り値

CMFCToolBarImages::GetDisabledImageAlpha

戻り値

解説

CMFCToolBarImages::GetFadedImageAlpha

戻り値

解説

CMFCToolBarImages::GetImageSize

パラメーター

戻り値

解説

CMFCToolBarImages::GetImageWell

戻り値

パブリックコンストラクター

パブリックメソッド

データメンバー