IImageList::Merge-Methode (commoncontrols.h)

Erstellt ein neues Image, indem zwei vorhandene Images kombiniert werden. Mit dieser Methode wird auch eine neue Imageliste erstellt, in der das Image gespeichert werden soll.

Syntax

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

Parameter

[in] i1

Typ: int

Ein Wert vom Typ int , der den Index des ersten vorhandenen Images enthält.

[in] punk2

Typ: IUnknown*

Ein Zeiger auf die IUnknown-Schnittstelle der Bildliste, die das zweite Bild enthält.

[in] i2

Typ: int

Ein Wert vom Typ int , der den Index des zweiten vorhandenen Images enthält.

[in] dx

Typ: int

Ein Wert vom Typ int , der die x-Komponente des Offsets des zweiten Bilds relativ zum ersten Bild enthält.

[in] dy

Typ: int

Ein Wert vom Typ int , der die y-Komponente des Offsets des zweiten Bilds relativ zum ersten Bild enthält.

[out] riid

Typ: REFIID

Eine IID der Schnittstelle für die neue Bildliste.

[out] ppv

Typ: PVOID*

Ein unformatierter Zeiger auf die Schnittstelle für die neue Bildliste.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Das neue Bild besteht aus dem zweiten Bild, das transparent über das erste gezeichnet wird. Die Maske für das neue Bild wird abgerufen, indem die Masken der beiden vorhandenen Bilder mit dem bitweisen OR-Operator kombiniert werden.

Um IImageList::Merge zu verwenden, geben Sie Comctl32.dll Version 6 im Manifest an. Weitere Informationen zu Manifesten finden Sie unter Aktivieren von visuellen Formatvorlagen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	commoncontrols.h
DLL	Comctl32.dll (Version 6.0 oder höher)