ImageList_Replace-Funktion (commctrl.h)

Ersetzt ein Bild in einer Bildliste durch ein neues Image.

Syntax

BOOL ImageList_Replace(
  HIMAGELIST himl,
  int        i,
  HBITMAP    hbmImage,
  HBITMAP    hbmMask
);

Parameter

himl

Typ: HIMAGELIST

Ein Handle für die Bildliste.

i

Typ: int

Ein Index des zu ersetzenden Bilds.

hbmImage

Typ: HBITMAP

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

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: BOOL

Gibt bei erfolgreicher Ausführung nonzero zurück, oder andernfalls null.

Hinweise

Die ImageList_Replace-Funktion kopiert die Bitmap in eine interne Datenstruktur. Stellen Sie sicher, dass Sie die DeleteObject-Funktion verwenden, um hbmImage und hbmMask zu löschen, nachdem die Funktion zurückgegeben wurde.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	commctrl.h
Bibliothek	Comctl32.lib
DLL	Comctl32.dll