IMAGELISTDRAWPARAMS 結構 (commoncontrols.h)

發行項
06/08/2023

包含影像清單繪製作業的相關資訊，並與 IImageList：:D raw 函式搭配使用。

語法

typedef struct _IMAGELISTDRAWPARAMS {
  DWORD      cbSize;
  HIMAGELIST himl;
  int        i;
  HDC        hdcDst;
  int        x;
  int        y;
  int        cx;
  int        cy;
  int        xBitmap;
  int        yBitmap;
  COLORREF   rgbBk;
  COLORREF   rgbFg;
  UINT       fStyle;
  DWORD      dwRop;
  DWORD      fState;
  DWORD      Frame;
  COLORREF   crEffect;
} IMAGELISTDRAWPARAMS;

成員

cbSize

類型： DWORD

這個結構的大小，以位元組為單位。

himl

類型： HIMAGELIST

包含要繪製之影像之影像清單的控制碼。

i

類型： int

要繪製之影像之以零起始的索引。

hdcDst

類型： HDC

目的地裝置內容的控制碼。

x

類型： int

指定影像繪製位置的 X 座標。

y

類型： int

指定繪製影像位置的 Y 座標。

cx

類型： int

值，指定要繪製的圖元數目，相對於 xBitmap 和 yBitmap所指定的繪圖作業左上角。如果 cx 和 cy 為零，則 Draw 會繪製整個有效區段。方法無法確保參數有效。

cy

類型： int

xBitmap

類型： int

x 座標，指定參考影像本身的繪圖作業左上角。 xBitmap和yBitmap上方影像的圖元不會出現。

yBitmap

類型： int

指定繪圖作業左上角的 Y 座標，參考影像本身。 xBitmap和yBitmap上方影像的圖元不會出現。

rgbBk

類型： COLORREF

影像背景色彩。此參數可以是應用程式定義的 RGB 值或下列其中一個值。

值	意義
CLR_DEFAULT	預設背景色彩。影像是使用影像清單背景色彩繪製。
CLR_NONE	沒有背景色彩。影像會以透明方式繪製。

rgbFg

類型： COLORREF

影像前景色彩。只有當 fStyle 包含 ILD_BLEND25 或 ILD_BLEND50 旗標時，才會使用此成員。此參數可以是應用程式定義的 RGB 值或下列其中一個值：

值	意義
CLR_DEFAULT	預設的前景色彩。影像是使用系統反白顯示色彩做為前景色彩來繪製。
CLR_NONE	沒有混合色彩。影像會與目的地裝置內容的色彩混合。

fStyle

類型： UINT

指定繪圖樣式的旗標，並選擇性地指定重迭影像。如需重迭影像的相關資訊，請參閱本主題結尾的批註一節。此成員可以包含一或多個影像清單繪圖旗標。

dwRop

類型： DWORD

指定點陣作業程式碼的值。這些程式碼會定義來源矩形的色彩資料如何與目的地矩形的色彩資料結合，以達到最終色彩。如果 fStyle 不包含 ILD_ROP 旗標，則會忽略此成員。一些常見的點陣作業代碼包括：

值	意義
黑暗	使用實體調色盤中索引零相關聯的色彩填滿目的矩形。 (在預設實體調色盤中，此色彩為黑色)。
DSTINVERT	反轉目的矩形。
MERGECOPY	使用布林值 AND 運算子，將來源矩形色彩與指定的圖樣合併。
MERGEPAINT	使用布林值 OR 運算子，將反向來源矩形色彩與目的地矩形色彩合併。
NOTSRCCOPY	將反向來源矩形複製到目的地。
NOTSRCERASE	使用布林值 OR 運算子結合來源和目的矩形色彩。反轉結果色彩。
PATCOPY	將指定的模式複製到目的地點陣圖中。
PATINVERT	使用布林 XOR 運算子，結合指定的圖樣色彩與目的矩形色彩。
PATPAINT	結合圖樣色彩與反轉的來源矩形色彩，並使用布林值 OR 運算子，將結果與目的矩形色彩結合。
SRCAND	使用布林值 AND 運算子結合來源和目的矩形色彩。
SRCCOPY	將來源矩形直接複製到目的地矩形。
SRCERASE	使用布林值 AND 運算子，結合目的地矩形的反轉色彩與來源矩形色彩。
SRCINVERT	使用布林 XOR 運算子結合來源和目的地矩形色彩。
SRCPAINT	使用布林值 OR 運算子結合來源和目的矩形色彩。
白	使用實體調色盤中第一個索引相關聯的色彩填滿目的矩形。此色彩是預設實體調色盤的白色。

fState

類型： DWORD

指定繪圖狀態的旗標。此成員可以包含一或多個影像清單狀態旗標。您必須使用第 6 版comctl32.dll使用此成員。請參閱。

Frame

類型： DWORD

搭配 Alpha 混合 效果使用。

與 ILS_ALPHA搭配使用時，此成員會保留 Alpha 色板的值。此值可以是從 0 到 255，其中 0 完全透明，而 255 則完全不透明。

您必須使用第 6 版comctl32.dll使用此成員。請參閱。

crEffect

類型： DWORD

用於光暈和陰影效果的色彩。您必須使用第 6 版comctl32.dll使用此成員。請參閱。

備註

重迭影像是在這個結構的 i 成員中指定的主要影像頂端繪製的影像。若要指定重迭影像，請使用位 OR 運算子將 fStyle 與 INDEXTOOVERLAYMASK 宏結合，並傳遞宏中重迭影像的單一式索引。此影像先前必須使用 ImageList_SetOverlayImage API 指定為重迭影像。

若要從 fStyle擷取重迭影像，請使用位 AND 運算子將 fStyle 遮罩為 ILD_OVERLAYMASK 值。

Comctl32.dll第 6 版無法轉散發。若要使用Comctl32.dll第 6 版，您必須在資訊清單中指定它。如需資訊清單的詳細資訊，請參閱啟用視覺樣式。

規格需求


最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
標頭	commoncontrols.h (include Commctrl.h)

共用方式為

IMAGELISTDRAWPARAMS 結構 (commoncontrols.h)

語法

成員

備註

規格需求

意見反應

其他資源