Partager via

IImageList ::Merge, méthode (commoncontrols.h)

  • Article

Crée une image en combinant deux images existantes. Cette méthode crée également une liste d’images dans laquelle stocker l’image.

Syntaxe

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

Paramètres

[in] i1

Type : int

Valeur de type int qui contient l’index de la première image existante.

[in] punk2

Type : IUnknown*

Pointeur vers l’interface IUnknown de la liste d’images qui contient la deuxième image.

[in] i2

Type : int

Valeur de type int qui contient l’index de la deuxième image existante.

[in] dx

Type : int

Valeur de type int qui contient le composant x du décalage de la deuxième image par rapport à la première image.

[in] dy

Type : int

Valeur de type int qui contient le composant y du décalage de la deuxième image par rapport à la première image.

[out] riid

Type : REFIID

IID de l’interface pour la nouvelle liste d’images.

[out] ppv

Type : PVOID*

Pointeur brut vers l’interface de la nouvelle liste d’images.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

La nouvelle image se compose de la deuxième image dessinée en toute transparence sur la première. Le masque de la nouvelle image est obtenu en combinant les masques des deux images existantes avec l’opérateur OR au niveau du bit.

Pour utiliser IImageList ::Merge, spécifiez Comctl32.dll version 6 dans le manifeste. Pour plus d’informations sur les manifestes, consultez Activation des styles visuels.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête commoncontrols.h
DLL Comctl32.dll (version 6.0 ou ultérieure)