共用方式為

ImageList_Create 函式 (commctrl.h)

  • 發行項

在指定的裝置內容中繪製影像清單專案。

語法

BOOL ImageList_Draw(
  HIMAGELIST himl,
  int        i,
  HDC        hdcDst,
  int        x,
  int        y,
  UINT       fStyle
);

參數

himl

類型： HIMAGELIST

影像清單的控制碼。

i

類型： int

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

hdcDst

類型： HDC

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

x

類型： int

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

y

類型： int

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

fStyle

類型： UINT

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

值 意義
ILD_BLEND
ILD_BLEND25
 繪製影像，將 25% 與系統醒目提示色彩混合。 如果影像清單不包含遮罩，這個值就不會有任何作用。
ILD_BLEND50
 繪製影像，將 50% 與系統醒目提示色彩混合。 如果影像清單不包含遮罩，這個值就不會有任何作用。
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
API 集合 ext-ms-win-shell-comctl32-init-l1-1-1 (于 Windows 10 10.0.14393 版)