Freigeben über


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