IImageList：：SetOverlayImage 方法 (commoncontrols.h)

將指定的影像新增至做為重迭遮罩的影像清單。映射清單在 Common Controls 4.70 版和更早版本中最多可以有四個重疊遮罩， 4.71 版或更新版本中最多可以有 15 個覆迭遮罩。方法會將重迭遮罩索引指派給指定的影像。

語法

HRESULT SetOverlayImage(
  [in] int iImage,
  [in] int iOverlay
);

[in] iImage

類型： int

int 類型的值，其中包含影像清單中的影像之以零起始的索引。此索引會識別要當做重迭遮罩使用的影像。

[in] iOverlay

類型： int

int 類型的值，其中包含重疊遮罩的一個索引。

類型： HRESULT

如果此方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

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

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

若要使用 IImageList：：SetOverlayImage，請在指令清單中指定第 6 版 Comctl32.dll。如需指令清單的詳細資訊，請參閱啟用可視化樣式。