IImageList::Replace-Methode (commoncontrols.h)

Artikel
03/04/2024

Ersetzt ein Bild in einer Bildliste durch ein neues Image.

Syntax

HRESULT Replace(
  [in]           int     i,
  [in]           HBITMAP hbmImage,
  [in, optional] HBITMAP hbmMask
);

Parameter

[in] i

Typ: int

Ein Wert vom Typ int , der den Index des zu ersetzenden Bilds enthält.

[in] hbmImage

Typ: HBITMAP

Ein Handle für die Bitmap, die das Bild enthält.

[in, optional] hbmMask

Typ: HBITMAP

Ein Handle für die Bitmap, die die Maske enthält. Wenn keine Maske mit der Bildliste verwendet wird, wird dieser Parameter ignoriert.

Rückgabewert

Typ: HRESULT

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

Hinweise

IImageList::Replace kopiert die Bitmap in eine interne Datenstruktur. Sie müssen DeleteObject verwenden, um hbmImage und hbmMask zu löschen, nachdem die Methode zurückgegeben wurde.

Um IImageList::Replace 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 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	commoncontrols.h
DLL	Comctl32.dll (Version 6.0 oder höher)

Freigeben über