Метод 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, укажите в манифесте Comctl32.dll версии 6. Дополнительные сведения о манифестах см. в разделе Включение визуальных стилей.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	commoncontrols.h
DLL	Comctl32.dll (версия 6.0 или более поздняя)