共用方式為

ImageList_DrawEx函式 (commctrl.h)

  • 發行項

在指定的裝置內容中繪製影像清單專案。 函式會使用指定的繪圖樣式，並將影像與指定的色彩混合。

語法

BOOL ImageList_DrawEx(
  HIMAGELIST himl,
  int        i,
  HDC        hdcDst,
  int        x,
  int        y,
  int        dx,
  int        dy,
  COLORREF   rgbBk,
  COLORREF   rgbFg,
  UINT       fStyle
);

參數

himl

類型： HIMAGELIST

影像清單的控制碼

i

類型： int

要繪製之影像的索引。

hdcDst

類型： HDC

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

x

類型： int

要繪製在指定裝置內容中的 X 座標。

y

類型： int

要繪製在指定裝置內容的 Y 座標。

dx

類型： int

相對於影像左上角繪製之影像部分的寬度。 如果 dx 和 dy 為零，函式會繪製整個影像。 函式不會確保參數有效。

dy

類型： int

要繪製之影像部分的高度，相對於影像左上角。 如果 dx 和 dy 為零，函式會繪製整個影像。 函式不會確保參數有效。

rgbBk

類型： COLORREF

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

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

rgbFg

類型： COLORREF

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

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

fStyle

類型： UINT

繪圖樣式，並選擇性地重迭影像。 如需指定重迭影像索引的相關資訊，請參閱本主題結尾的批註一節。 此參數可以是重迭影像索引和下列一或多個值的組合：

值 意義
ILD_BLEND
ILD_BLEND25
 繪製影像，並將 25% 與 rgbFg指定的混合色彩混合。 如果影像清單不包含遮罩，這個值就不會有任何作用。
ILD_BLEND50
 繪製影像，並將 50% 與 rgbFg指定的混合色彩混合。 如果影像清單不包含遮罩，這個值就不會有任何作用。
ILD_FOCUS
ILD_IMAGE
 如果重迭不需要繪製遮罩，請設定此旗標。 此旗標會導致 ImageList_DrawEx 只繪製影像，並忽略遮罩。
ILD_MASK
 繪製遮罩。
ILD_NORMAL
 使用影像清單的背景色彩繪製影像。 如果背景色彩是CLR_NONE值，則會使用遮罩以透明方式繪製影像。
ILD_SELECTED
ILD_TRANSPARENT
 使用遮罩以透明方式繪製影像，而不論背景色彩為何。 如果影像清單不包含遮罩，這個值就不會有任何作用。

傳回值

類型： BOOL

如果成功，則傳回非零，否則傳回零。

備註

重迭影像會以透明方式繪製在 i 參數中指定的主要映射上。 若要在 fStyle 參數中指定重迭影像，請使用 INDEXTOOVERLAYMASK 宏來移動重迭影像的單一索引。 使用 OR 運算子，以邏輯方式結合宏的傳回值與 fStyle 參數中指定的繪圖樣式旗標。 您必須先使用 ImageList_SetOverlayImage 函式將此影像指定為重迭影像。

規格需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 commctrl.h
程式庫 Comctl32.lib
Dll Comctl32.dll