Método IImageList::Merge (commoncontrols.h)

Crea una nueva imagen combinando dos imágenes existentes. Este método también crea una nueva lista de imágenes en la que se va a almacenar la imagen.

Sintaxis

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

Parámetros

[in] i1

Tipo: int

Valor de tipo int que contiene el índice de la primera imagen existente.

[in] punk2

Tipo: IUnknown*

Puntero a la interfaz IUnknown de la lista de imágenes que contiene la segunda imagen.

[in] i2

Tipo: int

Valor de tipo int que contiene el índice de la segunda imagen existente.

[in] dx

Tipo: int

Valor de tipo int que contiene el componente x del desplazamiento de la segunda imagen en relación con la primera imagen.

[in] dy

Tipo: int

Valor de tipo int que contiene el componente y del desplazamiento de la segunda imagen en relación con la primera imagen.

[out] riid

Tipo: REFIID

IiD de la interfaz para la nueva lista de imágenes.

[out] ppv

Tipo: PVOID*

Puntero sin formato a la interfaz de la nueva lista de imágenes.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

La nueva imagen consta de la segunda imagen dibujada de forma transparente sobre la primera. La máscara de la nueva imagen se obtiene combinando las máscaras de las dos imágenes existentes con el operador OR bit a bit.

Para usar IImageList::Merge, especifique Comctl32.dll versión 6 en el manifiesto. Para obtener más información sobre los manifiestos, vea Habilitación de estilos visuales.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	commoncontrols.h
Archivo DLL	Comctl32.dll (versión 6.0 o posterior)