IImageList::Remove-Methode (commoncontrols.h)

Entfernt ein Bild aus einer Bildliste.

Syntax

HRESULT Remove(
  [in] int i
);

Parameter

[in] i

Typ: int

Ein Wert vom Typ int , der den Index des zu entfernenden Images enthält. Wenn dieser Parameter -1 ist, entfernt die -Methode alle Bilder.

Rückgabewert

Typ: HRESULT

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

Hinweise

Wenn ein Bild entfernt wird, passen sich die Indizes der verbleibenden Bilder so an, dass sie immer zwischen null und eins 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.

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