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

Cria uma nova imagem combinando duas imagens existentes. Esse método também cria uma nova lista de imagens na qual armazenar a imagem.

Sintaxe

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

Um valor do tipo int que contém o índice da primeira imagem existente.

[in] punk2

Tipo: IUnknown*

Um ponteiro para a interface IUnknown da lista de imagens que contém a segunda imagem.

[in] i2

Tipo: int

Um valor do tipo int que contém o índice da segunda imagem existente.

[in] dx

Tipo: int

Um valor do tipo int que contém o componente x do deslocamento da segunda imagem em relação à primeira imagem.

[in] dy

Tipo: int

Um valor do tipo int que contém o componente y do deslocamento da segunda imagem em relação à primeira imagem.

[out] riid

Tipo: REFIID

Um IID da interface para a nova lista de imagens.

[out] ppv

Tipo: PVOID*

Um ponteiro bruto para a interface da nova lista de imagens.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

A nova imagem consiste na segunda imagem desenhada de forma transparente sobre a primeira. A máscara para a nova imagem é obtida combinando as máscaras das duas imagens existentes com o operador OR bit a bit.

Para usar IImageList::Merge, especifique Comctl32.dll versão 6 no manifesto. Para obter mais informações sobre manifestos, consulte Habilitando estilos visuais.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	commoncontrols.h
DLL	Comctl32.dll (versão 6.0 ou posterior)