Freigeben über


ImageList_Remove-Funktion (commctrl.h)

Entfernt ein Bild aus einer Bildliste.

Syntax

BOOL ImageList_Remove(
  HIMAGELIST himl,
  int        i
);

Parameter

himl

Typ: HIMAGELIST

Ein Handle für die Bildliste.

i

Typ: int

Der Index des zu entfernenden Bildes. Wenn dieser Parameter -1 ist, entfernt die Funktion alle Bilder.

Rückgabewert

Typ: BOOL

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

Hinweise

Wenn ein Bild entfernt wird, werden die Indizes der verbleibenden Bilder so angepasst, dass die Bildindizes immer von 0 bis 1 kleiner als die Anzahl der Bilder in der Bildliste liegen. Wenn Sie z. B. das Bild bei Index 0 entfernen, wird Bild 1 zu Bild 0, Bild 2 zu Bild 1 usw.

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

Weitere Informationen

ImageList_RemoveAll