共用方式為

ImageList_SetOverlayImage 函式 (commctrl.h)

  • 發行項

將指定的影像新增至要當做重迭遮罩使用的影像清單。 映射清單在 4.70 版和更早版本中最多可以有四個重疊遮罩，4.71 版最多可以有 15 個。 函式會將重迭遮罩索引指派給指定的影像。

語法

BOOL ImageList_SetOverlayImage(
  [in] HIMAGELIST himl,
  [in] int        iImage,
  [in] int        iOverlay
);

參數

[in] himl

類型： HIMAGELIST

影像清單的句柄。

[in] iImage

類型： int

himl 影像清單中的影像以零起始的索引。 此索引會識別要作為重迭遮罩使用的影像。

[in] iOverlay

類型： int

覆迭遮罩的單一型索引。

傳回值

類型： BOOL

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

備註

重迭遮罩是以透明方式繪製在另一個影像上繪製的影像。 若要在影像上繪製重迭遮罩，請呼叫 ImageList_Draw 或 ImageList_DrawEx 函式。 這些函式的 fStyle 參數可以使用 INDEXTOOVERLAYMASK 宏來指定重疊遮罩索引。

呼叫此方法會失敗，並傳回E_INVALIDARG，除非影像清單是使用遮罩建立的。

規格需求

需求 值
最低支援的用戶端 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 版)