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 值或下列其中一個值：

rgbFg

類型： COLORREF

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

fStyle

類型： UINT

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

傳回值

類型： BOOL

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

備註

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

規格需求