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) |