CMFCToolBarImages Class

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at CMFCToolBarImages Class.

The images on a toolbar. The CMFCToolBarImages class manages toolbar images loaded from application resources or from files.

class CMFCToolBarImages : public CObject  

Public Constructors

NameDescription
CMFCToolBarImages::CMFCToolBarImagesConstructs a CMFCToolBarImages object.

Public Methods

NameDescription
CMFCToolBarImages::AdaptColors
CMFCToolBarImages::AddIconAdds an icon to the toolbar images.
CMFCToolBarImages::AddImageAdds a bitmap to the toolbar images.
CMFCToolBarImages::CleanUp
CMFCToolBarImages::ClearFrees the system resources that were allocated to this object.
CMFCToolBarImages::ConvertTo32BitsConverts underlined bitmaps to 32 bpp images.
CMFCToolBarImages::CopyImageToClipboard
CMFCToolBarImages::CopyTo
CMFCToolBarImages::CreateFromImageListInitializes the toolbar images from an image list ( CImageList Class).
CMFCToolBarImages::CreateRegionFromImage
CMFCToolBarImages::DeleteImageDeletes the image that has a specified index from the toolbar images if this set of toolbar images contains user-defined images.
CMFCToolBarImages::DrawDraws a single toolbar image (button).
CMFCToolBarImages::DrawEx
CMFCToolBarImages::EnableRTL
CMFCToolBarImages::EndDrawImageFrees system resources after a toolbar image is drawn.
CMFCToolBarImages::ExtractIconReturns the icon that has a specified image index from the toolbar images.
CMFCToolBarImages::FillDitheredRectFills a rectangle by using a brush that has the toolbar background colors.
CMFCToolBarImages::GetAlwaysLight
CMFCToolBarImages::GetBitsPerPixelReturns current resolution of underlined images.
CMFCToolBarImages::GetCountReturns the number of images on the toolbar.
CMFCToolBarImages::GetDisabledImageAlphaReturns the alpha channel value that is used for disabled images.
CMFCToolBarImages::GetFadedImageAlpha
CMFCToolBarImages::GetImageSizeRetrieves either the size of the toolbar images that are stored in memory (source size), or the size of the toolbar images that are drawn on the screen (destination size).
CMFCToolBarImages::GetImageWellReturns the handle to the bitmap that contains all the toolbar images.
CMFCToolBarImages::GetImageWellLight
CMFCToolBarImages::GetLastImageRect
CMFCToolBarImages::GetLightPercentage
CMFCToolBarImages::GetMapTo3DColors
CMFCToolBarImages::GetMask
CMFCToolBarImages::GetResourceOffsetReturns the image index for a specified resource ID.
CMFCToolBarImages::GetScaleReturns current scale ratio of underlined images.
CMFCToolBarImages::GetTransparentColor
CMFCToolBarImages::GrayImagesGrays the toolbar images to make them look disabled.
CMFCToolBarImages::Is32BitTransparencySupportedDetermines whether the operating system supports 32-bit alpha blending.
CMFCToolBarImages::IsPreMultiplyAutoCheck
CMFCToolBarImages::IsRTLDetermines whether right-to-left (RTL) support is enabled.
CMFCToolBarImages::IsReadOnlyDetermines whether the toolbar images are read-only.
CMFCToolBarImages::IsScaledTells whether the underlined images are scaled or not.
CMFCToolBarImages::IsUserImagesListDetermines whether this set of toolbar images contains user-defined images.
CMFCToolBarImages::IsValidDetermines whether this set of toolbar images contains a valid toolbar image.
CMFCToolBarImages::LoadLoads toolbar images from system resources or from a file.
CMFCToolBarImages::LoadStr
CMFCToolBarImages::MapFromSysColor
CMFCToolBarImages::MapTo3dColors
CMFCToolBarImages::MapToSysColor
CMFCToolBarImages::MapToSysColorAlpha
CMFCToolBarImages::MirrorHorizontally mirrors all of the toolbar images.
CMFCToolBarImages::MirrorBitmapHorizontally mirrors a bitmap.
CMFCToolBarImages::MirrorBitmapVert
CMFCToolBarImages::MirrorVert
CMFCToolBarImages::OnSysColorChange
CMFCToolBarImages::PrepareDrawImageAllocates the resources that are required to draw a toolbar image at a specified size.
CMFCToolBarImages::SaveStores the toolbar images in a file if this set of toolbar images contains user-defined images.
CMFCToolBarImages::SetAlwaysLight
CMFCToolBarImages::SetDisabledImageAlphaSets the alpha channel value that is used for disabled images.
CMFCToolBarImages::SetFadedImageAlpha
CMFCToolBarImages::SetImageSizeSets the size of a toolbar image (source size).
CMFCToolBarImages::SetLightPercentage
CMFCToolBarImages::SetMapTo3DColors
CMFCToolBarImages::SetPreMultiplyAutoCheck
CMFCToolBarImages::SetSingleImage
CMFCToolBarImages::SetTransparentColorSets the transparent color of the toolbar images.
CMFCToolBarImages::SmoothResizeSmoothly resizes underlined images.
CMFCToolBarImages::UpdateImageUpdates a user-defined toolbar image from a bitmap.

Protected Methods

NameDescription
CMFCToolBarImages::PreMultiplyAlpha

Data Members

NameDescription
CMFCToolBarImages::m_bDisableTrueColorAlphaTRUE if truecolor alpha blending (32-bit color) is disabled.

The full bitmap of toolbar images managed by CMFCToolbarImages consists of one or more small toolbar images (buttons) of a fixed size.

The following example demonstrates how to configure a CMFCToolBarImages object by using various methods in the CMFCToolBarImages class. The example shows how to set the size of the toolbar image, load an image, and set the transparent color of the image. This code snippet is part of the Visual Studio Demo sample.

	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

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

void AdaptColors(
    COLORREF clrBase,  
    COLORREF clrTone);

Parameters

[in] clrBase
[in] clrTone

Remarks

Adds an icon to the list of toolbar images.

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

Parameters

[in] hIcon
A handle to the icon to be added.

[in] bAlphaBlend
TRUE if this icon is used with alpha blending; otherwise FALSE.

Return Value

The zero-based index of the toolbar image that was added if the method is successful; otherwise -1.

Adds a bitmap to the toolbar images.

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

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

Parameters

[in] hbmp
The handle to the bitmap to add.

[in] bSetBitPerPixel
TRUE if the CMFCToolBarImages object uses the color depth (bits per pixel) of the new image; FALSE if the CMFCToolbarImages object keeps the current color depth.

[in] imageList
A reference to a CMFCToolbarImages object that contains the image to add.

[in] nIndex
The index in the source CMFCToolbarImages object of the image to add.

Return Value

The number of toolbar images that the CMFCToolBarImages object maintains after the new bitmap was added successfully; -1 if the operation failed.

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

static void __stdcall CleanUp();

Remarks

Frees the system resources that the CMFCToolbarImages object allocated.

void Clear();

Constructs a CMFCToolBarImages object.

CMFCToolBarImages();

Remarks

Constructs a CMFCToolBarImages object, initializes its rendering engine and sets the image size to its default value 16x15 pixels. Use CMFCToolBarImages::SetImageSize to change the image size before you add images.

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

BOOL CopyImageToClipboard(int iImage);

Parameters

[in] iImage

Return Value

Remarks

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

BOOL CopyTo(CMFCToolBarImages& imageList);

Parameters

[in] imageList

Return Value

Remarks

Initializes the toolbar images from a CImageList Class object.

BOOL CreateFromImageList(const CImageList& imageList);

Parameters

[in] imageList
The image list to be used as a source for toolbar images.

Return Value

Always returns TRUE.

Remarks

Use this function to quickly initialize the toolbar images list from an external image list.

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

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

Parameters

[in] bmp
[in] clrTransparent

Return Value

Remarks

Deletes the user-defined image that has a specified index from the toolbar images.

BOOL DeleteImage(int iImage);

Parameters

[in] iImage
Specifies the zero-based index of the image to delete.

Return Value

TRUE if the image was deleted successfully; FALSE if the image index is invalid, the CMFCToolbarImages object is temporary, the CMFCToolbarImages object does not contain user-defined images, or if some other error occurred.

Draws a single toolbar image.

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);

Parameters

[in] pDC
A pointer to a device context.

[in] x
The X coordinate of the left side of the rectangle where the image is to be drawn.

[in] y
The Y coordinate of the top of the rectangle where the image is to be drawn.

[in] iImageIndex
The zero-based index of the image to be displayed.

[in] bHilite
TRUE if the image is to be highlighted; otherwise FALSE.

[in] bDisabled
TRUE if the image is to be drawn in the disabled style; otherwise FALSE.

[in] bIndeterminate
TRUE if the image is to be drawn in the indeterminate state style; otherwise FALSE.

[in] bShadow
TRUE if the image is to be drawn with a drop shadow; otherwise FALSE.

[in] bInactive
TRUE if the image is to be drawn in the inactive state style; otherwise FALSE.

[in] alphaSrc
The alpha channel (opacity) value. A value of 255 means the image is drawn opaque. A value of 0 means the image is drawn transparent. This value is used only for 32 bit color images and for images that displayed a Windows Vista glass style.

Return Value

TRUE if the specified image was displayed successfully; FALSE if the image index was invalid or some other error occurred.

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

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

Parameters

[in] pDC
[in] rect
[in] iImageIndex
[in] horzAlign
[in] vertAlign
[in] rectSrc
[in] 0
[in] 0)
[in] alphaSrc

Return Value

Remarks

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

static void __stdcall EnableRTL(BOOL bIsRTL = TRUE);

Parameters

[in] bIsRTL

Remarks

Frees system resources that CMFCToolBarImages::PrepareDrawImage allocated after you draw a toolbar image by calling CMFCToolBarImages::Draw.

void EndDrawImage(CAfxDrawState& ds);

Parameters

[in] ds
A reference to the CAfxDrawState object that was passed to the PrepareDrawImage method.

Returns the icon that has a specified image index from the toolbar images.

HICON ExtractIcon(int nIndex);

Parameters

[in] nIndex
The zero-based index in the image list at which the image to be extracted as an icon is located.

Return Value

A handle to the extracted icon, or NULL if nIndex is out of range.

Fills a rectangle with the toolbar background colors.

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

Parameters

[in] pDC
A pointer to a device context.

[in] rect
The coordinates of a rectangle to fill.

Remarks

Use this method to fill a rectangle with a color that is the average of the system colors COLOR_BTNFACE and COLOR_BTNHIGHLIGHT. If the system is using 256 or fewer colors, the rectangle will be filled with a dithered pattern of those two colors instead.

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

BOOL GetAlwaysLight() const;  

Return Value

Remarks

Returns the number of images in the toolbar images list.

int GetCount() const;  

Return Value

The number of images in the CMFCToolbarImages object.

Returns the alpha channel (opacity) value that is used for disabled images.

static BYTE GetDisabledImageAlpha();

Return Value

The current alpha channel value.

Remarks

You can call CMFCToolBarImages::SetDisabledImageAlpha to change the alpha channel value.

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

static BYTE __stdcall GetFadedImageAlpha();

Return Value

Remarks

Retrieves either the size of the toolbar images that are stored in memory (source size), or the size of the toolbar images that are drawn on the screen (destination size).

SIZE GetImageSize(BOOL bDest=FALSE) const;  

Parameters

[in] bDest
TRUE to retrieve the destination size; FALSE to retrieve the source image size.

Return Value

A SIZE structure, which specifies the size of an image in pixels.

Remarks

The size of the source image is the size of the images that are stored in the CMFCToolbarImages object. You can call CMFCToolBarImages::SetImageSize to set the source size. The default value is 16x15 pixels.

By default, the destination image size is 0x0. You specify the destination size when you call CMFCToolBarImages::PrepareDrawImage. The CMFCToolBarImages::EndDrawImage method resets the destination size to the default value.

Returns the handle to the bitmap that contains all the toolbar images.

HBITMAP GetImageWell() const;  

Return Value

A handle to a bitmap that contains toolbar images.

Remarks

The toolbar images are stored in a row in a single bitmap that is known as an image well. To find a toolbar image in the image well, multiply the index of the image by the width of the toolbar images (see CMFCToolBarImages::GetImageSize) to obtain the horizontal offset of the image inside the image well.

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

HBITMAP GetImageWellLight() const;  

Return Value

Remarks

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

CRect GetLastImageRect() const;  

Return Value

Remarks

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

int GetLightPercentage() const;  

Return Value

Remarks

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

BOOL GetMapTo3DColors() const;  

Return Value

Remarks

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

HBITMAP GetMask(int iImage);

Parameters

[in] iImage

Return Value

Remarks

Returns the image index for a specified resource ID.

int GetResourceOffset(UINT uiResId) const;  

Parameters

[in] uiResId
An image resource ID.

Return Value

An image index if the method was successful; -1 if the image with the specified resource ID does not exist.

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

COLORREF GetTransparentColor() const;  

Return Value

Remarks

Grays the toolbar images to make them look disabled.

BOOL GrayImages(int nGrayImageLuminancePercentage);

Parameters

[in] nGrayImageLuminancePercentage
Luminance percentage.

Return Value

TRUE if images in the collection were grayed successfully; otherwise FALSE.

Remarks

This method modifies the toolbar images by averaging the red, green, and blue components of each pixel and multiplying the result by nGrayImageLuminancePercentage divided by 100. If nGrayImageLuminancePercentage is zero or negative, the default value of 130 is used instead.

System_CAPS_ICON_note.jpg Note

If you want to undo the change, you must reload the images from the source. You can do this by calling CMFCToolBarImages::Load or CMFCToolBarImages::UpdateImage (only for user-defined images), or by calling CMFCToolBarImages::Clear and adding the images again by calling CMFCToolBarImages::AddIcon or CMFCToolBarImages::AddImage.

Specifies whether the operating system supports 32-bit alpha blending.

static BOOL Is32BitTransparencySupported();

Return Value

TRUE if 32-bit alpha blending is supported; otherwise FALSE.

Remarks

Use this static method to determine at runtime whether the operating system supports 32-bit alpha blending. This feature is supported on Windows 2000 and later versions.

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

BOOL IsPreMultiplyAutoCheck() const;  

Return Value

Remarks

Specifies whether the toolbar images are read-only.

BOOL IsReadOnly() const;  

Return Value

TRUE if the toolbar images are read-only, otherwise FALSE.

Remarks

The CMFCToolbarImages object is read-only when the bitmap with toolbar images was loaded from a read-only file, or when the bitmap was copied in using the CMFCToolBarImages::CopyTemp method.

Specifies whether right-to-left (RTL) support is enabled.

static BOOL IsRTL();

Return Value

TRUE if RTL support is enabled; otherwise FALSE.

Remarks

RTL support is used when the application is localized to a language that is read from right to left, such as Arabic, Hebrew, Persian, or Urdu.

Specifies whether this set of toolbar images contains user-defined images.

BOOL IsUserImagesList() const;  

Return Value

TRUE if the CMFCToolbarImages object contains user-defined toolbar images; otherwise FALSE.

Indicates whether this set of toolbar images contains a valid toolbar image.

BOOL IsValid() const;  

Return Value

TRUE if a CMFCToolbarImages object is valid; otherwise FALSE.

Remarks

The CMFCToolBarImages object is not valid when its handle to a bitmap with toolbar images is NULL.

Loads toolbar images from system resources or from a file.

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

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

Parameters

[in] uiResID
The ID of a bitmap resource.

[in] hinstRes
An instance of the resource DLL.

[in] bAdd
TRUE to add the loaded bitmap to the existing bitmap, or FALSE to replace the existing bitmap.

[in] lpszBmpFileName
A path to a disk file from which to load the bitmap.

[in] nMaxFileSize
Maximum number of bytes in the bitmap file; or 0 to load the bitmap regardless of file size. If the size of the file exceeds this maximum size, the method returns FALSE and does not load the bitmap.

Return Value

TRUE if the bitmap was loaded successfully; otherwise FALSE.

Remarks

If the file has the read-only attribute, the image list is marked as read-only.

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

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

Parameters

[in] lpszResourceName
[in] hinstRes
[in] bAdd

Return Value

Remarks

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

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

Parameters

[in] color
[in] bUseRGBQUAD

Return Value

Remarks

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

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

Parameters

[in] bUseRGBQUAD
[in] clrSrc
[in] clrDest

Return Value

Remarks

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

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

Parameters

[in] color
[in] bUseRGBQUAD

Return Value

Remarks

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

static COLORREF __stdcall MapToSysColorAlpha(COLORREF color);

Parameters

[in] color

Return Value

Remarks

Replaces the toolbar images with their horizontal mirror image.

BOOL Mirror();

Return Value

TRUE if the images were successfully mirrored; otherwise FALSE.

Remarks

This method is used to support right-to-left writing systems.

Replaces a bitmap with its horizontal mirror image.

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

Parameters

[in, out] hbmp
A handle to bitmap to mirror.

[in] cxImage
Width of the image in pixels.

Return Value

TRUE if the image was successfully mirrored; otherwise FALSE.

Remarks

This function is used to support right-to-left writing systems.

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

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

Parameters

[in] hbmp
[in] cyImage

Return Value

Remarks

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

BOOL MirrorVert();

Return Value

Remarks

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

void OnSysColorChange();

Remarks

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

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

BOOL PreMultiplyAlpha(HBITMAP hbmp);

Parameters

[in] hbmp
[in] bAutoCheckPremlt

Return Value

Remarks

TRUE if truecolor alpha blending (32-bit color) is disabled.

static BOOL m_bDisableTrueColorAlpha;  

Remarks

Set this member variable to FALSE to enable truecolor alpha-blending for toolbar images.

The default value is TRUE for backward compatibility.

Allocates the resources that are required to draw a toolbar image at a specified size.

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

Parameters

[in] ds
A reference to CAfxDrawState structure, which stores the allocated resources between image rendering stages.

[in] sizeImageDest
Specifies the size of a destination image.

[in] bFadeInactive
TRUE if you want inactive images to be drawn faded.

Return Value

TRUE if the resources required to draw the toolbar image were allocated successfully, otherwise FALSE.

Remarks

After you call this method, you can call CMFCToolBarImages::Draw any number of times. After you finished drawing, you must call CMFCToolBarImages::EndDrawImage to release the resources allocated by PrepareDrawImage.

Stores the toolbar images in a file if this set of toolbar images contains user-defined images.

BOOL Save(LPCTSTR lpszBmpFileName=NULL);

Parameters

lpszBmpFileName
A path to a disk file.

Return Value

TRUE if the toolbar images were saved successfully; otherwise FALSE.

Remarks

Call this method to store the user-defined images into a disk file. If lpszBmpFileName is NULL, the method stores the bitmap into the file from which the bitmap was loaded by the CMFCToolBarImages::Load method.

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

void SetAlwaysLight(BOOL bAlwaysLight = TRUE);

Parameters

[in] bAlwaysLight

Remarks

Sets the alpha channel (opacity) value that is used for disabled images.

static void SetDisabledImageAlpha(BYTE nValue);

Parameters

[in] nValue
The new value of the alpha channel.

Remarks

Use this method to set a custom alpha value for disabled images. The default value is 127, which causes disabled button images to be semitransparent. If you set a value of 0, disabled images will be completely transparent. If you set a value of 255, disabled images will be completely opaque.

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

static void __stdcall SetFadedImageAlpha(BYTE nValue);

Parameters

[in] nValue

Remarks

Sets the size of each toolbar image (source size).

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

Parameters

[in] sizeImage
The new size of toolbar images.

Remarks

By default the size of the toolbar image is 16x15 pixels. Call this method if you want to use toolbar images of a different size.

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

void SetLightPercentage(int nValue);

Parameters

[in] nValue

Remarks

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

void SetMapTo3DColors(BOOL bMapTo3DColors);

Parameters

[in] bMapTo3DColors

Remarks

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

void SetPreMultiplyAutoCheck(BOOL bAuto = TRUE);

Parameters

[in] bAuto

Remarks

This topic is included for completeness. For more detail see the source code located in the VC\atlmfc\src\mfc folder of your Visual Studio installation.

void SetSingleImage();

Remarks

Sets the transparent color of the toolbar images.

COLORREF SetTransparentColor(COLORREF clrTransparent);

Parameters

[in] clrTransparent
An RGB value.

Return Value

The previous transparent color.

Remarks

When you or the framework call CMFCToolBarImages::Draw, the method does not draw any pixel that matches the color specified by clrTransparent.

Updates a user-defined toolbar image from a bitmap.

BOOL UpdateImage(
    int iImage,  
    HBITMAP hbmp);

Parameters

[in] iImage
The zero-based index of the image to update.

[in] hbmp
A handle to the bitmap from which to update the image.

Return Value

TRUE if the image was updated successfully; FALSE if the image list is not user-defined or temporary.

Converts underlined bitmaps to 32 bpp images.

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

Parameters

clrTransparent
Specifies transparent color of underlined bitmaps.

Remarks

Returns current resolution of underlined images.

int GetBitsPerPixel() const;  

Return Value

An integer value representing the current resolution of underlined images, in bits per pixel (bpp).

Remarks

Returns the current scale ratio of underlined images.

double GetScale() const;  

Return Value

A value representing the current scale ratio.

Remarks

Tells whether the underlined images are scaled or not.

BOOL IsScaled () const;  

Return Value

TRUE if underlined images are scaled; otherwise FALSE.

Remarks

Smoothly resizes underlined images.

BOOL SmoothResize(double dblImageScale);

Parameters

dblImageScale
Scale ratio.

Return Value

TRUE if resize succeeds; otherwise FALSE.

Remarks

Hierarchy Chart
Classes
CObject Class
CMFCToolBar Class
CMFCToolBarButton Class

Show: