IImageList::SetOverlayImage-Methode (commoncontrols.h)

Artikel
02/26/2024

Fügt der Liste der Bilder, die als Überlagerungsmasken verwendet werden, ein angegebenes Bild hinzu. Eine Bildliste kann bis zu vier Überlagerungsmasken in Common Controls Version 4.70 und früher und bis zu 15 in Version 4.71 oder höher enthalten. Die -Methode weist dem angegebenen Bild einen Überlagerungsmaskenindex zu.

Syntax

HRESULT SetOverlayImage(
  [in] int iImage,
  [in] int iOverlay
);

Parameter

[in] iImage

Typ: int

Ein Wert vom Typ int , der den nullbasierten Index eines Bilds in der Bildliste enthält. Dieser Index identifiziert das Bild, das als Überlagerungsmaske verwendet werden soll.

[in] iOverlay

Typ: int

Ein Wert vom Typ int , der den einbasierten Index der Überlagerungsmaske enthält.

Rückgabewert

Typ: HRESULT

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

Hinweise

Eine Überlagerungsmaske ist ein Bild, das transparent über ein anderes Bild gezeichnet wird. Um eine Überlagerungsmaske über ein Bild zu zeichnen, rufen Sie IImageList::D raw auf. Der fStyle-Parameter dieser Funktionen kann das Makro INDEXTOOVERLAYMASK verwenden, um einen Überlagerungsmask-Maskenindex anzugeben.

Ein Aufruf dieser Methode schlägt fehl und gibt E_INVALIDARG zurück, es sei denn, die Bildliste wird mithilfe einer Maske erstellt.

Um IImageList::SetOverlayImage 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)

Freigeben über