IImageList：：Merge 方法 (commoncontrols.h)

結合兩個現有的映像來建立新的映像。 這個方法也會建立新的映射清單，以在其中儲存影像。

語法

HRESULT Merge(
  [in]  int      i1,
  [in]  IUnknown *punk2,
  [in]  int      i2,
  [in]  int      dx,
  [in]  int      dy,
  [out] REFIID   riid,
  [out] void     **ppv
);

參數

[in] i1

類型： int

int 類型的值，其中包含第一個現有影像的索引。

[in] punk2

類型： IUnknown*

包含第二個影像之影像清單 之 IUnknown 介面的指標。

[in] i2

類型： int

int 類型的值，其中包含第二個現有影像的索引。

[in] dx

類型： int

int 類型的值，其中包含相對於第一個影像之第二個影像之位移的 x 元件。

[in] dy

類型： int

int 類型的值，其中包含相對於第一個影像之第二個影像位移的 Y 元件。

[out] riid

類型： REFIID

新影像清單介面的 IID。

[out] ppv

類型： PVOID*

新影像清單介面的原始指標。

傳回值

類型： HRESULT

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

備註

新的影像是由第二個影像所組成，以透明方式繪製在第一個影像上。 將兩個現有影像的遮罩與位 OR 運算子結合，以取得新影像的遮罩。

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

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	commoncontrols.h
Dll	Comctl32.dll (6.0 版或更新版本)