CMFCToolBarImages 類別
工具列上的影像。 類別 CMFCToolBarImages 會管理從應用程式資源或檔案載入的工具列影像。
如需詳細資訊，請參閱 Visual Studio 安裝的 VC\atlmfc\src\mfc 資料夾中的原始程式碼 。
語法
class CMFCToolBarImages : public CObject
成員
公用建構函式
| 名稱 | 描述 |
|---|---|
| CMFCToolBarImages：：CMFCToolBarImages | 建構 CMFCToolBarImages 物件。 |
公用方法
受保護的方法
| 名稱 | 描述 |
|---|---|
| CMFCToolBarImages：:P reMultiplyAlpha |
資料成員
| 名稱 | 描述 |
|---|---|
| CMFCToolBarImages：：m_bDisableTrueColorAlpha | True 是表示 如果停用 truecolor Alpha 混合 （32 位色彩）。 |
備註
由 管理 CMFCToolbarImages 之工具列影像的完整點陣圖是由固定大小的一或多個小型工具列影像（按鈕）所組成。
範例
下列範例示範如何使用 類別中的 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));
繼承階層架構
CMFCToolBarImages
需求
標頭： afxtoolbarimages.h
CMFCToolBarImages：：AdaptColors
void AdaptColors(
COLORREF clrBase,
COLORREF clrTone);
參數
[in] clrBase
[in] clrTone
備註
CMFCToolBarImages：：AddIcon
將圖示新增至工具列影像清單。
int AddIcon(
HICON hIcon,
BOOL bAlphaBlend=FALSE);
參數
hIcon
[in]要加入之圖示的控制碼。
bAlphaBlend
[in]如果此圖示與 Alpha 混合搭配使用，則為 TRUE;否則為 FALSE。
傳回值
如果方法成功，則為工具列影像的以零起始的索引;否則為 -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建構 物件、初始化其轉譯引擎，並將影像大小設定為預設值 16x15 圖元。 使用 CMFCToolBarImages：：SetImageSize 來變更影像大小，再新增影像。
CMFCToolBarImages：：CopyImageToClipboard
BOOL CopyImageToClipboard(int iImage);
參數
[in] iImage
傳回值
備註
CMFCToolBarImages：：CopyTo
BOOL CopyTo(CMFCToolBarImages& imageList);
參數
[in] imageList
傳回值
備註
CMFCToolBarImages：：CreateFromImageList
從 CImageList 類別 物件初始化工具列影像。
BOOL CreateFromImageList(const CImageList& imageList);
參數
imageList
[in]要作為工具列影像來源的影像清單。
傳回值
一律會傳回 TRUE。
備註
使用此函式，從外部影像清單快速初始化工具列影像清單。
CMFCToolBarImages：：CreateRegionFromImage
static HRGN __stdcall CreateRegionFromImage(
HBITMAP bmp,
COLORREF clrTransparent);
參數
[in] Bmp
[in] clrTransparent
傳回值
備註
CMFCToolBarImages：:D eleteImage
從工具列影像中刪除具有指定索引的使用者定義影像。
BOOL DeleteImage(int iImage);
參數
iImage
[in]指定要刪除之影像的以零起始的索引。
傳回值
如果已成功刪除映射，則為 TRUE;FALSE 表示影像索引無效、 CMFCToolbarImages 物件為暫時性、 CMFCToolbarImages 物件不包含使用者定義的影像，或發生其他錯誤。
CMFCToolBarImages：:D raw
繪製單一工具列影像。
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
[in]裝置內容的指標。
x
[in]要繪製影像之矩形左側的 X 座標。
y
[in]要繪製影像之矩形頂端的 Y 座標。
iImageIndex
[in]要顯示之影像之以零起始的索引。
bHilite
[in]如果要反白顯示影像，則為 TRUE;否則為 FALSE。
bDisabled
[in]如果影像要以停用的樣式繪製，則為 TRUE;否則為 FALSE。
bIndeterminate
[in]如果影像要以不確定的狀態樣式繪製，則為 TRUE;否則為 FALSE。
bShadow
[in]如果影像要以陰影繪製，則為 TRUE;否則為 FALSE。
b 非使用中
[in]如果影像要以非使用中狀態樣式繪製，則為 TRUE;否則為 FALSE。
AlphaSrc
[in]Alpha 色板 （不透明度） 值。 值為 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);
參數
[in] Pdc
[in] 矩形
[in] iImageIndex
[in] horzAlign
[in] vertAlign
[in] rectSrc
[in] AlphaSrc
傳回值
備註
CMFCToolBarImages：：EnableRTL
static void __stdcall EnableRTL(BOOL bIsRTL = TRUE);
參數
[in] bIsRTL
備註
CMFCToolBarImages：：EndDrawImage
藉由呼叫 CMFCToolBarImages：:D raw ，釋放 CMFCToolBarImages：:P repareDrawImage 之後所配置的系統資源 。
void EndDrawImage(CAfxDrawState& ds);
參數
Ds
[in]傳遞至 PrepareDrawImage 方法之 CAfxDrawState 物件的參考。
CMFCToolBarImages：：ExtractIcon
傳回工具列影像中具有指定影像索引的圖示。
HICON ExtractIcon(int nIndex);
參數
nIndex
[in]影像清單中要擷取為圖示之影像的以零起始的索引。
傳回值
擷取圖示的控制碼，如果 nIndex 超出範圍，則為 Null。
CMFCToolBarImages：：FillDitheredRect
以工具列背景色彩填滿矩形。
static void FillDitheredRect(
CDC* pDC,
const CRect& rect);
參數
pDC
[in]裝置內容的指標。
矩形
[in]要填滿之矩形的座標。
備註
使用此方法，將矩形填滿為系統色彩的平均值，COLOR_BTNFACE和COLOR_BTNHIGHLIGHT。 如果系統使用 256 或更少的色彩，矩形會改為填滿這兩種色彩的任一圖案。
CMFCToolBarImages：：GetAlwaysLight
BOOL GetAlwaysLight() const;
傳回值
備註
CMFCToolBarImages：：GetCount
傳回工具列影像清單中的影像數目。
int GetCount() const;
傳回值
物件中的 CMFCToolBarImages 影像數目。
CMFCToolBarImages：：GetDisabledImageAlpha
傳回用於停用影像的 Alpha 色板 （不透明度） 值。
static BYTE GetDisabledImageAlpha();
傳回值
目前的 Alpha 色板值。
備註
您可以呼叫 CMFCToolBarImages：：SetDisabledImageAlpha 來變更 Alpha 色板值。
CMFCToolBarImages：：GetFadedImageAlpha
static BYTE __stdcall GetFadedImageAlpha();
傳回值
備註
CMFCToolBarImages：：GetImageSize
擷取儲存在記憶體中的工具列影像大小（來源大小），或在螢幕上繪製的工具列影像大小（目的地大小）。
SIZE GetImageSize(BOOL bDest=FALSE) const;
參數
bDest
[in]TRUE 可擷取目的地大小;FALSE 可擷取來源影像大小。
傳回值
SIZE結構，指定以圖元為單位的影像大小。
備註
來源影像的大小是儲存在 CMFCToolbarImages 物件中的 影像大小。 您可以呼叫 CMFCToolBarImages：：SetImageSize 來設定來源大小。 預設值為 16x15 圖元。
根據預設，目的地映射大小會0x0。 當您呼叫 CMFCToolBarImages：:P repareDrawImage 時，您可以指定目的地大小。 CMFCToolBarImages：：EndDrawImage 方法會將目的地大小重設為預設值。
CMFCToolBarImages：：GetImageWell
傳回包含所有工具列影像的點陣圖控制碼。
HBITMAP GetImageWell() const;
傳回值
包含工具列影像之點陣圖的控制碼。
備註
工具列影像會儲存在稱為 影像 的單一點陣圖中。 若要在影像中尋找工具列影像，請將影像的索引乘以工具列影像的寬度（請參閱 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);
參數
[in] iImage
傳回值
備註
CMFCToolBarImages：：GetResourceOffset
傳回指定資源識別碼的影像索引。
int GetResourceOffset(UINT uiResId) const;
參數
uiResId
[in]映射資源識別碼。
傳回值
如果方法成功，則為影像索引;如果具有指定資源識別碼的映射不存在，則為 -1。
CMFCToolBarImages：：GetTransparentColor
COLORREF GetTransparentColor() const;
傳回值
備註
CMFCToolBarImages：：GrayImages
將工具列影像呈現灰色，使其看起來已停用。
BOOL GrayImages(int nGrayImageLuminancePercentage);
參數
nGrayImageLuminancePercentage
[in]亮度百分比。
傳回值
如果集合中的影像已成功呈現灰色，則為 TRUE;否則為 FALSE。
備註
此方法會藉由平均每個圖元的紅色、綠色和藍色元件來修改工具列影像，並將結果乘以 nGrayImageLuminancePercentage 除以 100。 如果 nGrayImageLuminancePercentage 為零或負數，則會改用預設值 130。
注意
如果您想要復原變更，您必須從來源重載映射。 您可以呼叫 CMFCToolBarImages：：Load 或 CMFCToolBarImages：：UpdateImages：：UpdateImage 或呼叫 CMFCToolBarImages：：Clear ，然後藉由呼叫 CMFCToolBarImages：：AddIcon 或 CMFCToolBarImages：：AddImage 再次新增映射。
CMFCToolBarImages：：Is32BitTransparencySupported
指定作業系統是否支援 32 位 Alpha 混合。
static BOOL Is32BitTransparencySupported();
傳回值
如果支援 32 位 Alpha 混合，則為 TRUE;否則為 FALSE。
備註
使用此靜態方法來判斷作業系統是否支援 32 位 Alpha 混合。 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 支援，例如阿拉伯文、希伯來文、波斯文或 Urdu。
CMFCToolBarImages：：IsUserImagesList
指定這個工具列影像集是否包含使用者定義的影像。
BOOL IsUserImagesList() const;
傳回值
如果 CMFCToolBarImages 物件包含使用者定義的工具列影像，則為 TRUE，否則為 FALSE。
CMFCToolBarImages：：IsValid
指出這組工具列影像是否包含有效的工具列影像。
BOOL IsValid() const;
傳回值
如果 CMFCToolBarImages 物件有效，則為 TRUE;否則為 FALSE。
備註
當 CMFCToolBarImages 物件具有工具列影像的點陣圖控制碼為 Null 時，物件無效。
CMFCToolBarImages：：Load
從系統資源或檔案載入工具列影像。
BOOL Load(
UINT uiResID,
HINSTANCE hinstRes=NULL,
BOOL bAdd=FALSE);
BOOL Load(
LPCTSTR lpszBmpFileName,
DWORD nMaxFileSize = 819200);
參數
uiResID
[in]點陣圖資源的識別碼。
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);
參數
[in] lpszResourceName
[in] hinstRes
[in] bAdd
傳回值
備註
CMFCToolBarImages：：MapFromSysColor
static COLORREF __stdcall MapFromSysColor(
COLORREF color,
BOOL bUseRGBQUAD = TRUE);
參數
[in] 顏色
[in] bUseRGBQUAD
傳回值
備註
CMFCToolBarImages：：MapTo3dColors
BOOL MapTo3dColors(
BOOL bUseRGBQUAD = TRUE,
COLORREF clrSrc = (COLORREF)-1,
COLORREF clrDest = (COLORREF)-1);
參數
[in] bUseRGBQUAD
[in] clrSrc
[in] clrDest
傳回值
備註
CMFCToolBarImages：：MapToSysColor
static COLORREF __stdcall MapToSysColor(
COLORREF color,
BOOL bUseRGBQUAD = TRUE);
參數
[in] 顏色
[in] bUseRGBQUAD
傳回值
備註
CMFCToolBarImages：：MapToSysColorAlpha
static COLORREF __stdcall MapToSysColorAlpha(COLORREF color);
參數
[in] 顏色
傳回值
備註
CMFCToolBarImages：：Mirror
使用其水準鏡像影像取代工具列影像。
BOOL Mirror();
傳回值
如果已成功鏡像影像，則為 TRUE;否則為 FALSE。
備註
這個方法可用來支援由右至左寫入系統。
CMFCToolBarImages：：MirrorBitmap
以其水準鏡像影像取代點陣圖。
static BOOL MirrorBitmap(
HBITMAP& hbmp,
int cxImage);
參數
hbmp
[in， out]要鏡像之點陣圖的控制碼。
cxImage
[in]影像寬度以圖元為單位。
傳回值
如果已成功鏡像影像，則為 TRUE;否則為 FALSE。
備註
此函式用來支援由右至左寫入系統。
CMFCToolBarImages：：MirrorBitmapVert
static BOOL __stdcall MirrorBitmapVert(
HBITMAP& hbmp,
int cyImage);
參數
[in] hbmp
[in] cyImage
傳回值
備註
CMFCToolBarImages：：MirrorVert
BOOL MirrorVert();
傳回值
備註
CMFCToolBarImages：：OnSysColorChange
void OnSysColorChange();
備註
CMFCToolBarImages：:P reMultiplyAlpha
static BOOL __stdcall PreMultiplyAlpha(
HBITMAP hbmp,
BOOL bAutoCheckPremlt);
BOOL PreMultiplyAlpha(HBITMAP hbmp);
參數
[in] hbmp
[in] bAutoCheckPremlt
傳回值
備註
CMFCToolBarImages：：m_bDisableTrueColorAlpha
True 是表示 如果停用 truecolor Alpha 混合 （32 位色彩）。
static BOOL m_bDisableTrueColorAlpha;
備註
將此成員變數設定為 FALSE，以啟用工具列影像的 truecolor Alpha 混合。
預設值為 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);
參數
[in] bAlwaysLight
備註
CMFCToolBarImages：：SetDisabledImageAlpha
設定用於停用影像的 Alpha 色板 （不透明度） 值。
static void SetDisabledImageAlpha(BYTE nValue);
參數
nValue
[in]Alpha 色板的新值。
備註
使用這個方法可設定已停用影像的自訂 Alpha 值。 預設值為 127，導致停用的按鈕影像成為半透明。 如果您設定值為 0，則停用的影像將會完全透明。 如果您設定 255 的值，則停用的影像將會完全不透明。
CMFCToolBarImages：：SetFadedImageAlpha
static void __stdcall SetFadedImageAlpha(BYTE nValue);
參數
[in] nValue
備註
CMFCToolBarImages：：SetImageSize
設定每個工具列影像的大小（來源大小）。
void SetImageSize(
SIZE sizeImage,
BOOL bUpdateCount=FALSE);
參數
sizeImage
[in]工具列影像的新大小。
備註
工具列影像的大小預設為 16x15 圖元。 如果您想要使用不同的大小的工具列影像，請呼叫此方法。
CMFCToolBarImages：：SetLightPercentage
void SetLightPercentage(int nValue);
參數
[in] nValue
備註
CMFCToolBarImages：：SetMapTo3DColors
void SetMapTo3DColors(BOOL bMapTo3DColors);
參數
[in] bMapTo3DColors
備註
CMFCToolBarImages：：SetPreMultiplyAutoCheck
void SetPreMultiplyAutoCheck(BOOL bAuto = TRUE);
參數
[in] 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]要更新之映射之以零起始的索引。
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。
備註
另請參閱
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應